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STUDENT GUIDE 


INTRODUCTION 
This course is designed for the programmer of an RSX-11M 
system. A system programmer must troubleshoot system problems and 


write needed privileged code. 


As a system programmer, your responsibilities will include 
the following: 


e Determining features needed on system. 

e Performing System Generations (SYSGENS). 

e Maintaining the software by installing patches. 

e Determining the cause(s) of system crashes. 

e Providing needed privileged tasks. 

e Writing new directive code. 

e Assisting application programmers with system problems. 


This course is designed to give you the knowledge and skills 
necessary to carry out these tasks. 


COURSE GOALS 


Upon completing this course, you should be able to: 

1. Install and maintain RSX-11M software. 

2. Use output from CDA to solve system problems. 

3. Write privileged tasks which access the system data base. 
4. Write privileged tasks which call system routines. 


5. Write a new directive processing routine and add the directive 
to the system. 


6. Determine system status by examining the system data base. 


7. Use knowledge of the operating system to improve performance 
of applications software. 
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NON-GOALS 
The following are not goals of this course: 
1. The course does not teach you how to write a device driver. 


2. The course does not teach you how to create a_user-written 
Command Line Interpreter. 


3. The course does not teach you how to make any modifications to 
system source code. Specifically, it will not teach you how 
to modify DCL in any way. 


PREREQUISITES 


You should have already taken RSX-11M Programming’ in 
FORTRAN/MACRO, or have equivalent experience using RSX-11M. You 
Should also be able to read and understand MACRO-11 code. 


COURSE ORGANIZATION 


The student workbook handout is organized into modules’ which 
correspond to the major topics covered by the instructor during 
the course. Each module is designed to support the lecture by 
providing you with notes and exercises to guide your study. 


A module is composed of five parts: 


1. An Introduction which provides an overview of the module. It 
explains in general terms what the module covers and how the 
material within the module is related to your needs. Often, 
it introduces some of the important concepts detailed in the 
module. 


2. Objectives which list the knowledge and skills you should 
obtain as a result of studying the module. Read these before 
the corresponding lecture, and review them after completion of 
the module and its exercises. 


3. Resources which provide a list of reference materials’ for 
further information about the topics of the module and related 
topics. You should familiarize yourself with the reference 
materials because they are your primary source of information 
after you complete the course. 


Your instructor may suggest selected readings as preparation 
for a lecture, or for review and study after the lecture. 
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The module text which provides brief notes on topics covered 
in the lecture, with printed copies of lists, tables, 
diagrams, etc. your instructor may uSe in class. The texts 
provide you with notes to review after the lecture, and 
reduces somewhat the note-taking you must do during lecture. 


Note that the module text is a supplement to the lecture. It 
is not intended to be tutorial reading for learning the 
material on your own. Nor is it intended to replace the 
function of reference manuals which fully document’ the 
software. You are strongly encouraged to supplement’ these 
notes with notes of your own and with references to the system 
documentation. 


Module Exercises which are designed to help you practice and 
test the knowledge acquired during lecture and study. If you 
can perform all of the written and/or lab exercises at the end 
of the module, you have mastered the objectives of that 
module. 


Your instructor may suggest particular lab exercises to 
concentrate on, if time or equipment limitations make it 
impossible to perform all of them. In addition, your 
instructor may provide additional suggestions for lab 
activities. 


Modules 


There are thirteen modules of this course. The following is 


a brief list of their major topics: 


iP 
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OVERVIEW OF RSX-11M describes the operating system and its 
goals. 


THE SYSTEM DATA BASE describes the most important data 
structures and lists in the system data base. 


EXECUTIVE MODULES describes the most important Executive 
modules, 


FILE SYSTEM OVERVIEW describes the structure of a FILES-11 
volume and the data structures needed to process it. 


SYSTEM GENERATION describes the system generation process. 
(For reference only; this module is optional.) 


PHYSICAL AND VIRTUAL MEMORY describes partitions, allocation 
of memory to tasks, checkpointing, function and use of memory 
management. 


Lois 
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TASK MANAGEMENT describes the life cycle of a task. 


SYSTEM SYNCHRONIZATION describes trap and interrupt 
processing, and access to the system data base. 


WRITING PRIVILEGED TASKS describes writing, assembling, and 
building privileged tasks. 


SYSTEM CRASHES uses CDA to troubleshoot system problems. 


DIRECTIVE PROCESSING describes the directive dispatcher, the 
directive dispatch table, and directive processing routines. 


I/O PROCESSING describes the components of the I/O system, 
ACPs, and QIO processing. 


DEVICE DRIVER PROCESSING describes the driver data base and 
the structure of standard device drivers. 
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RESOURCES 


ae 


RSX-11M Release Notes (AA~-2573G-TC) 


Contains the most recent version information and should be 
read thoroughly before any system generation. Includes 
information on patching. 


RSX-11M System Generation and Installation Guide 


Contains complete documentation on the installation and SYSGEN 
procedures. 


RSX-11M/M-Plus I/O Operations Reference Manual 


Contains documentation on the FCS macros and subroutines. 


RSX-11M/M-Plus Executive Reference Manual 


Contains descriptions of all system directives. 


RSX-11M/M-Plus Crash Dump Analyzer 


Explains how to use the CDA facilities. 


RSX-11M Guide to Writing an I/O Driver 


Contains a detailed description of the procedures involved in 
writing a new device driver. 
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OVERVIEW OF RSX-11M 


INTRODUCTION 


RSX-11M is designed to Support many applications with 
particular emphasis on real-time applications. For this reason, a 
large number of services are provided to the programmer. This 
module presents a brief overview of these features, many of which 
will be examined in detail in later modules. 


OBJECTIVES 


1. List the major design goals of RSX-11M. 
2. List the major features of RSX-11M. 


3. List the major components of RSX-11M. 


id 


OVERVIEW OF RSX-11M 


DESIGN GOALS 


Real-time system with 
8K word minimum Executive 
16K word minimal system (disk based, run time only) 


28K word system required for SYSGEN (version 4.86) 


Upward compatible with RSX-11D 
Support 
All PDP-11 processors 
Most processor options 
Full line of peripherals 
Provide system and task synchronization not relying on 
priorities 
"Beau ie extensive user facilities 
Complete file system 
Multiple language processors 


Debugging and maintainence tools 


task 


Allow for any number of simultaneously executing user tasks 


Avoid using processor priority to synchronize access to system 


data base 
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CHARACTERISTICS OF RSX-11M 


System Features 


Supports multiprogramming 


Several tasks can be memory-resident and 


time 
Improves efficiency of system 


Allows quick response to events 


active 


Provides some user control of some system functions 


Scheduling 
File access 
Completely 'Event-Driven' 
No ‘monolithic monitor' 
Executive entered only as a result of 
interrupt 
Disk-Based 
Tasks stored on disk until loaded 
Allows quick task startup 
Provides multi-tasking facilities 
Dynamic task requests 


Passing data between tasks 
Sharing memory areas between tasks 
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OVERVIEW OF RSX-11M 


Major Components of RSX-11M 


Executive - Contains code to perform system functions such as 
task scheduling, input/output operations, etc. 


File System - Provides efficient and convenient access to data 
and task files. 


Utilities - Provide services needed to program and support 
user applications. 


ae, 
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THE EXECUTIVE 


Components 


Use 


Trap and interrupt vectors - Used by hardware to provide trap 
and interrupt service. 


Vectors consist of 2 words: 


Word 1 - A value to go into the PC 
Word 2 - A value to go into the PS 


When a trap or interrupt occurs: 
Current values of PC and PS are pushed onto the stack 
Values in the vector are moved into the PC and PS 
System Stack - Maintained as temporary storage for system 
programs. 


System Common - Contains pointers to important areas of system 
data base. 


Executive Code - Performs system functions. 
Dynamic Storage Area - Contains most dynamically created 


system data structures. 


of Physical Memory 


Executive contained in lowest area of memory 


Size depends on features chosen at SYSGEN: not greater’ than 
20K words 


Executive has access to I/O page in top 4K words of address 
Space 


Some device drivers may not be included within Executive 


Some directive service routines may not be included within the 
Executive 
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TOP 4K WORDS 


1/0 PAGE OF ADDRESS SPACE 


USER 
AREA 


DYNAMIC STORAGE 
REGION 


EXECUTIVE eee 
(20 K WORDS 
MAXIMUM) 


SYSTEM STACK 


TRAP & INTERRUPT VECTORS 


Figure 1-1 Typical Use of Physical Memory 
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OVERVIEW OF RSX-11M 


THE FILE SYSTEM 


Design Goals 
e Allow programmer to organize data in a convenient manner 


e Provide protection from unauthorized access 


e Provide efficient use of disk space 


Components 
e Standard structures on disk and tape volumes 


e Ancillary control processor (ACP) to provide programming 
interface to file structured volumes 


FIIACP - For disk volumes 


MTAACP - For magnetic tape volumes 


e Application-oriented software 
FCS - File Control Services 


RMS - Record Management Services 


Ls 
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: USER | 
TASK 


RMS/FCS 
VIRTUAL BLOCKS 
(VIA QIO) 
| _ FILE 
EXECUTIVE 


od PROCESSOR 
(FI1ACP) 


LOGICAL BLOCKS 
DEVICE 
DRIVER | 


PHYSICAL 
VOLUME 


PHYSICAL BLOCKS 


Figure 1-2 The File System 
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OVERVIEW OF RSX-11M 


THE UTILITIES 


e Tasks distributed with operating system 
Perform common maintenance and development functions 


Not included in memory-resident Executive 


e Four general categories of utilities 


Language processors 


MACRO-11 
FORTRAN 


Program development utilities 


EDT 
EDI 
LBR 


System maintenance utilities 


BAD 
CMP 
VFY 
PAT 


File manipulation utilities 
PIP 


FLX 
DMP 
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THE SYSTEM DATA BASE 


INTRODUCTION 


The system data base includes the data Structures’ which 
describe the current state of the system to the Executive. Every 
operation within the system has its effect on the system data 
base. Similarly, the state of the system data base at the time an 
operation is requested determines the success and effect of the 
operation. 


Throughout this course, the system data base is used_ to 
explain the mechanics of various system operations. This module 
describes the most central system data structures, and how they 


are related. Future modules detail the data structures and their 
linkages. 


OBJECTIVES 


1. Describe the major system data structures associated with task 
- management. 


2. Describe the major system data structures associated with 
partition control. 


3. Describe the major system data structures associated with I/0 
device control. 


4. Describe how the Executive manages the Dynamic Storage Region. 
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STATIC AND DYNAMIC DATA STRUCTURES 


e Static data structures 
Created when system is built 


Contained in Executive modules 


Example: Data structures for standard devices selected at 
SYSGEN are in the Executive module SYSTB. 


e Dynamic data structures 
Created and eliminated as needed 
Contained in Dynamic Storage Region (DSR) 
Example: Data structures needed to define tasks to the 


system are in DSR. 


The Dynamic Storage Region 


e Contains dynamic data structures 
e Space allocated and deallocated as needed 
e Allocation of DSR: 
Performed by routines in module CORAL 
Length is multiple of 4 bytes 


Linked list of unallocated space is maintained by 
Executive 


No record of allocated space is kept 
First-fit algorithm is used 


List of preallocated I/O packets maintained if specified 
at SYSGEN 
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~$CRAVL 


ALLOCATED 
SPACE 


SIZE IN BYTES INCLUDING 2 BYTES FOR POINTER AND 
2 BYTES FOR SIZE FIELD 


Figure 2-1 The List of Free Space in DSR 
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BEFORE ALLOCATION 


POINTER TO NEXT FREE BLOCK 
SIZE OF FREE BLOCK (IN BYTES 


POINTER TO NEXT FREE BLOCK 
SIZE OF FREE BLOCK (IN BYTES 


POINTER TO NEXT FREE BLOCK=0 
SIZE OF FREE BLOCK (IN BYTES 


Figure 2-2 


AFTER ALLOCATION 


POINTER TO NEXT FREE BLOCK 
SIZE OF FREE BLOCK (IN BYTES 


POINTER TO NEXT FREE BLOCK=0 
SIZE OF FREE BLOCK (IN BYTES 


Allocating DSR 


$CRAVL 
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THE SYSTEM DATA BASE 


TASK-RELATED DATA STRUCTURES AND LISTS 


The Task Control Block (TCB) 

e Defines task to system 

e Contains information controlling task execution 
Task name 
Task priority 
Local event flags 


Task status words 


e Contains pointers to other data structures including: 


T.RCVL - Receive queue listhead 


Points to linked list of data blocks queued 
by the "SEND DATA' directive. 


T.ASTL - AST queue listhead 

Points to linked list of ASTs queued to task. 
T.UCB - Address of data structure (UCB) identifying TI: 
T.TCBL - Link word for System Task Directory 


T.PCB - Address of data structure (PCB) identifying 
partition in which task executes 


T.ACTL - Link word for Active Task List 


e@ Allows task to load and begin execution quickly 
Contains pointer to task image on disk 


Identifies partition in which to load task 


29 


THE SYSTEM DATA BASE 


T.LNK 
T.1OC/T.PRI 
T.CPCB 
T.NAM 


UTILITY LINK WORD 
1/0 PENDING COUNT TASK PRIORITY 
POINTER TO CHECKPOINT PCB 


TASK NAME 


IN RAD50 
RECEIVE QUEUE 


LISTHEAD 
AST QUEUE 


LISTHEAD 


TASK LOCAL 
Pom ae 


T.RCVL 


T.ASTL 


T.EFLG 


T.UCB 
T.TCBL 
T.STAT 


UCB ADDRESS FOR 'TI’ 
STD THREAD WORD 
FIRST STATUS WORD (BLOCKING BITS) 


Figure 2-4 The Task Control Block 
(First Part of Fixed Area) 


T.LBN/T.DPRI 
OF TASK LOAD IMAGE 
rea 
ak [———sreciriep ast uistnea | vsast 
AREA aurreneo vo count] __uwused | 1.110 
| SEReenias P tases‘. tesz 


Figure 2-4 The Task Control Block 
(Second Part of Fixed Area) 
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TCB 


ATTACHMENT DESCRIPTOR T.ATT 

Fixep | S/f[{ "4 LISTHEADt—(‘C™# 

EFW COUNT FOR sREF] RESERVED 
RECEIVE-BY-REFERENCE T.RRFL 

sii a 
“a OFFSPRING CONTROL T.OCBH 


OPTIONAL 
AREA 


BLOCK LISTHEAD 
OUTSTANDING OFFSPRING COUNT 


EVENT FLAG MASK WORD 


EVENT FLAG MASK ADDRESS 


GGEF USE COUNT | TASK HEADER LENGTH | T.HOLN 


PARENT/OFFSPRING 
AREA 
OTHER OPTIONS 


Figure 2-4 The Task Control Block 
(Optional Area) 


T.ROCT 
T.EFLM 


3t 


Offset 


T.STAT 


T.ST2 


TsSTs 


They 


context switch to the 


Symbol 


TS.EXE 
TS.RDN 
TS.MSG 
TS.NRP 
TS.OUT 
TS.CKP 
TS.CKR 


must 


T2.AST 
T2.DST 
T2.CHK 
T2.CKD 
T2.SEF 
T2. FAD 
T2.TIO 
T2.CAF 
T2.HLT 
T2.ABO 
T2. 

T2.STP 
T23 

T2.SPN 
T2. 

T2.WFR 


T3.ACP 
T3.PMD 
T3.REM 
T3.PRV 
T3.MCR 
T3.SLV 
T3.CLI 
T3.NSD 
T3.CAL 
T3.ROV 
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Table 2-1 


Value 


188068 
49800 
20888 
10088 

420 
208 
180 


NOTE 
The bits in T.STAT are called blocking 
all be clear for the Executive to 


1682808 
49000 
20888 
16888 

4800 
2808 
1086 
490 
208 
188 
49 
28 
1¢ 

4 

2 

1 


1BEBOB 
49000 
28890 
188080 
4980 
2080 
1889 
2890 
186 

4Q 


Task Status Words 


Meaning 


Task not in execution 

I/O rundown in progress 

Abort message being output 

Task mapped to nonresident region 
Task is out of memory 

Task is being checkpointed 

Task checkpointing requested 


bits. 
task. 


AST in progress 
AST recognition disabled 

Task not checkpointable 

Checkpointing disabled 

Task stopped for event flag 

Task fixed in memory 

Task engaged in terminal I/0 

Dynamic checkpoint space allocation failure 
Task is being halted 
Task marked for abort 
Saved T2.STP on AST in 
Task stopped 

Saved T2.SPN on AST in 
Task suspended 

Saved T2.WFR on AST in 
Task in wait for state 


progress 
progress 


progress 


Ancillary control processor 

Inhibit post mortem dump 

Remove task on exit 

Task is privileged 

Task requested as external MCR function 
Task is slaved 

Task is a command line interpreter 

Task does not allow send data 

Checkpoint space allocated in task image 
Task has resident overlays 
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The System Task Directory (STD) 
e Linked list of TCBs | 
@e Ordered by descending default priority 
e Begins at listhead STSKHD in System Common 
e Linked through location T.TCBL in the TCB 
e ‘Null Task' TCB is last entry 
"Null Task' used to anchor system task lists 


When 'Null Task' is scheduled, the idle loop is performed 
until another task becomes ready to run 


‘Null Task' TCB in System Common 


"Null Task' never executes 


e TCB is inserted when task is installed 

e New TCB inserted after others of same priority 

e System maintains pointers (in SYSCM) to special tasks in STD 
STKTCB - Current task TCB 


STKNPT 


Pointer to TCB of task termination task TKTN 


SMCRPT 


Pointer to TCB of MCR task 


SLDRPT - Pointer to loader TCB 
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$RQSCH 


$TKTCB 
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T.PRI 
T.TCBL 
T.DPRI 
TACTL 


< T.PRI 
T.TCBL 
T.DPRI 
T.ACTL 


T.PRI 
T.TCBL 
T.DPRI 


T.PRI 
T.TCBL 
T.DPRI 
T.ACTL 


AT 


eo 
T.TCBL 


T.DPRI 
T.ACTL 


T.PRI 


T.TCBL-O 
T.ACTL 


Figure 2-5 


248 
TCB OF 


(TYPICALLY) 


ay LOADER TASK 


160 


160 


100 


100 


50 


50 


130 


9 THIS TCB IS LOCATED IN THE 
EXECUTIVE MODULE SYSCM. 
IT IS THE NULL TASK’S TCB. 


The System Task Directory 
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The Active Task List (ATL) 


e Linked list of TCBs 

e Ordered by descending priority 

e Begins at SACTHD in System Common 

e Linked through T.ACTL in TCB 

e ‘Null Task' TCB is last entry 

e TCB inserted when requested; Task becomes active 


e New TCB inserted after others of same priority 
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$TSKHD 
T PRI 1248 
paee TTCBL TCB OF 
Bone f (TYPICALLY) 
TDPRI 
aoe TIE LOADER TASK 
$ROSCH 


T.TCBL 


T.DPRI 
T.ACTL 


T.DPRI 
T.ACTL 


$TKTCB 


THIS TCB IS LOCATED IN THE 
EXECUTIVE MODULE SYSCM. 


IT IS THE NULL TASK’S TCB. 


Figure 2-6 The Active Task List 
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PARTITION-RELATED DATA STRUCTURES AND LISTS 


The Partition Control Block (PCB) 

e Defines partition to system 

@ Contains information describing partition 
Partition name 
Physical starting address (32 word blocks number) 
Size of partition (in 32 word blocks) 
Partition busy word 
Partition status word 
Protection word 


Current UIC of owner task 


e Pointers to other data structures 
If subpartition PCB, pointer to the main partition PCB 
Pointer to next subpartition PCB 


Pointer to queue of TCBs of tasks waiting for space 
partition 


Pointer to attachment descriptor block for task 


Pointer to task header of resident task 
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LINK TO NEXT PARTITION PCB O P.LNK 
P.1OC PRIORITY OF PARTITION | 2 _ P.PRI 
PARTITION NAME 4 
P.NAM 
(IN RADIX-50) 6 
POINTER TO NEXT SUB-PARTITION 10 P.SUB 
12 P.MAIN 


PHYSICAL START ADDRESS OF PARTITION 
SIZE OF PARTITION 


PARTITION WAIT QUEUE LIST HEAD 
PARTITION SWAP SIZE (SYSTEM ONLY) 


ATTACHMENT DESCRIPTOR 
LIST HEAD 
EMS 


14 P.REL'P.HDR? 

16 P.BLKS'P.SIZE' 

20 P.WAIT 

22 P.SWS2° 

24 P.BUSY (TWO BYTES) 
26 P.TCB/P.OWN 

30 P.STAT 

32 P.HDR? 

34 P.PRO‘ 


P.ATT° 


32 WORD BLOCKS FOR MAPPED SYSTEMS 
BYTES FOR UNMAPPED SYST 


P.HDR=P.REL IN UNMAPPED SYSTEMS 

FOR SUB-PARTITIONS OF SYSTEM CONTROLLED PARTITIONS 
MAPPED SYSTEMS ONLY 

MAPPED SYSTEM WITH PLAS ONLY 


Figure 2-7 The Partition Control Block 
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Symbol 


PS.OUT 
PS.CKP 
PS.CKR 
PS.CHK 
PS.FXD 
PS.PER 
PS.LIO 
PS.NSF 
PS.COM 
PS.PIC 
PS.SYS 
PS.DRV 
PS.DEL 
PS.APR 
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Table 2-2 


Value 


186088 
40000 
208088 
19898 

4888 


Partition Status Word 
Meaning 
Partition is out of memory 


Partition checkpoint in progress 
Partition checkpoint requested 
Partition is not checkpointable 
Partition is fixed 

Parity error in partition 

Marked by shuffler for long I/0 
Partition is not shufflable 

Library or common block 

Position independent library of common 
System controlled partition 

Driver is loaded in partition 
Partition should be deleted when not attached 
Starting APR 

Starting APR 

Starting APR 
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The Partition List 


Linked list of PCBs 

Linked in order of increasing base address 
Begins at location $PARHD in System Common 
Linked through P.LNK in PCB 


PCB created and inserted in list by "SET /MAIN' or 'SET 
MCR or VMR command 


PCBs of subpartitions 
Task partitions 


Linked into list using P.LNK 
Linked to PCB of main partition using P.SUB 


System-controlled partitions 


Linked to main partition PCB using P.SUB 
Not linked through P.LNK 


4@ 


/SUB' 
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USER-CONTROLLED 
MAIN PARTITION 
WITHOUT SUBPARTITIONS 


USER-CONTROLLED 
MAIN PARTITION 
WITH 2 SUBPARTITIONS 


SYSTEM-CONTROLLED 
PARTITION WITH 

2 DYNAMICALLY 
CREATED SUBPARTITIONS 


P._LNK=? 
Le atte Ae aaa | 
P.SUB=0 
| LCM PMAIN 
Sa eee 


PCBS OF DYNAMICALLY ALLOCATED 
SUBPARTITIONS ARE CHAINED ACCORDING 
TO THE BASE ADDRESSES OF THEIR SUBPARTITIONS 


Figure 2-8 The Partition List 
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P.MAIN 
NON-RESIDENT, a ac PCRIOE 
ROASTING Wees P.TCB=0 MAIN PARTITION 
T.PCB aren! 
P-HDR=0 


TCB 
PCE | 
P.SUB a 
RESIDENT TASK fs DYNAMICALLY 
CREATED PCB 
|__PHDR _| 
a a 


ASK 
HEADER 


NON-RESIDENT, 
ACTIVE TASK 


TCB 
OTHER 
RESIDENT 
TASK 
TASK 
HEADER 


Figure 2-9 Relationship Between Task and Partition Structures 


TCB 


T.PCB CREATED PCB. 


P.HDR? 

PCB’S OF RESIDENT 
TASKS ARE CHAINED 
ACCORDING TO THE 
BASE ADDRESS OF 
THEIR SUBPARTITION, 


T.PCB aes 
freee =o DYNAMICALLY 
CREATED PCB 
(LAST) 
ae 
| P-HDR 
fs 


P.SUB=? 
EACH ACTIVE TASK 
DYNAMICALLY \ HAS ITS OWN 
PTCB CREATED PCB DYNAMICALLY 


c—— ———_ — —— ———— _— ee 
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DEVICE-RELATED DATA STRUCTURES AND LISTS 


The Device Control Block (DCB) 
e Describes physical device type 
e Contains information describing device 
Generic device name in ASCII (D.NAM) 
Physical units in system of this type (D.UNIT) 


Device functions supported (D.MSK) 


e Pointer to data structures describing physical units (D.UCB) 


e Pointer to entry points in device driver (D.DSP) 


O OD.LNK 
POINTER TO FIRST UCB OF THIS DEVICE TYPE |2 D.UCB 


4 D.NAM 


LOWEST UNIT NUMBER|6_ D.UNIT 


10 D.UCBL 
12 D.DSP 
14 D.MSK 


Figure 2-18 The Device Control Block 
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The Device List 

e Linked list of DCBs 

e Ordered by inclusion in SYSTB and by order of loading 
e Begins at listhead S$DEVHD in SYSCM 


e Linked through location D.LNK in DCB 


SYSCM 
$DEVHD 


D.LNK 


DCB FOR LP: 


D.LNK 


DCB FOR DB: 


D.LNK 


DCB FOR DK: 


Figure 2-11 The Device List 
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Other Structures 

e The Unit Control Block (UCB) 
One UCB per physical unit of type 
Size depends on device type 


Contains data used to describe physical unit 


e The Status Control Block (SCB) 
One SCB per controller or per line if multiplexer 
Size depends on device type 


Contains data needed to control I/O operations 


SYSCM D.LNK 
$DEVHD DCB FOR LP: 


D.UCB UCB FOR 
D.UCBL LPO: SCB 


D.LNK UCB FOR 
DCB FOR DB: DB: 


D.UCB Apes 
D.UCBL UCB FOR SCB 
DB1: 


D.LNK 
DCB FOR DK: 


D.UCB 
UCB FOR 


Figure 2-12 Other Data Structures 
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THE CLOCK QUEUE 


The Clock Queue Control Block 
e Describes time-dependent request 
e Contains eight words; last three depends on type of request 
e Five types of requests 
Mark Time 
Task request with periodic rescheduling 
Single shot task request 


Single shot internal subroutine (two types) 


O C.LNK 


POINTER TO NEXT CLOCK QUEUE CONTROL BLOCK 
EVENT FLAG NUMBER 
(MARK TIME ONLY) REQUEST TYPE 
TCB ADDRESS OR SYSTEM SUBROUTINE ADDRESS 


ABSOLUTE TIME LOW ORDER PART 
WHEN 
REQUEST COMES DUE HIGH ORDER PART 


C.EFN 3 2 C.RQT 


4 C.TCB 


6 C.TIM 


10 


12 


TYPE 
14 


DEPENDENT 
PARAMETERS 
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Figure 2-13 The Clock Queue Control Block 
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The Clock Queue 


e Linked list of Clock Queue Control Blocks 
e List ordered by increasing absolute time 


e Scanned by code in TDSCH when clock interrupt occurs 


SYSCM 
$CLKHD 


Figure 2-14 The Clock Queue 
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EXECUTIVE MODULES 


INTRODUCTION 


The Executive iS composed of a number of modules. Each 
module contains code which performs a specific function or class 
of related functions. To effectively function as a_ systems 
programmer, you must be able to locate this code. This module 
provides a quick overview of the major modules in the Executive. 


OBJECTIVES 


1. Recognize the general function of a module (i.e., general, 
directive processing, or device driver). 


2. Locate the code which performs a given Executive function. 


aL 


EXECUTIVE MODULES 


OVERVIEW 


e Over 9@ possible modules in the Executive 


@e Modules conditionally assembled using symbols contained in 
{11,1@]RSXMC.MAC 


e Three types of modules: 


General Executive modules 
Have names which relate to function 


Example: SYSCM - System Common 


Directive Processing modules 
Have 5 character names 
First two characters are 'DR' 


Last three characters indicate function 


Example: DRABO - Module for processing the abort 
directive 


Device Driver modules 
Have 5 character names 
First two characters indicate device type 


Last three characters are 'DRV' 


Example: DKDRV - Device driver for RK@5 disk drives 
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EXECUTIVE MODULES 


PRINCIPAL EXECUTIVE MODULES 


System Common (SYSCM) 


SCRAVL 
STSKHD 
SACTHD 
$PARHD 
SDEVHD 
SGGEF 

SCLKHD 
SFRKHD 
SCFLPT 
SUMRWT 


SHEADR 
STKNPT 
SSHFPT 
STKTCB 
SROSCH 
SMCRPT 
SLDRPT 


SCMBEG 
SUMRHD 
SCURPR 
SCOMEF 
SPWRFL 
SABTIM 
SSTKDP 
SINTCT 
SDYPMN 
SBTMSK 
SIOABM 
STKPS 

SCXDBL 


Contains pointers to system lists 


Pointer to first block of free pool space 
Pointer to STD 

Pointer to ATL 

Pointer to Partition List 

Pointer to Device List 

Pointer to Group Global Event Flag List 
Pointer to Clock Queue 

Pointer to Fork Queue 

Pointer to Checkpoint File PCB List 
Pointer to UMR wait queue 


Contains pointers to specific data blocks 


Pointer to header of current task 
Pointer to TCB of TKTN 

Pointer to TCB of shuffler 
Pointer to TCB of current task 
Pointer to TCB of requested task 
Pointer to TCB of MCR 

Pointer to TCB of loader 


General system data 


The TCB of the null task 

First UMR mapping assignment block 
Current task priority 

Common event flags 

Powerfail recovery request flag 
Absolute time counter 

Stack depth indicator 

Clock interrupt ticks count 
Days per month table 

Bit mask table 

I/O active bitmap 

Ticks per second 

Context switching disabled flag 
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EXECUTIVE MODULES 


System Entrance and Exit Routines (SYSXT) 


SDIRSV 
SFORK 

SFORK1 
SFORK2 
SINTSV 
SINTSE 


SINTSC 
SINTXT 
SDIRXT 
SSWSTK 


Contains routines used for entering and exiting the Executive 


Called when Executive entered by system trap 
Used to create FORK process by driver 

Used to create FORK process by non-driver 
Used to create FORK process by CINTS routine 
Called when Exec entered by interrupt 

Called when Exec entered by interrupt (Error 
Logging) 

Called when Exec entered by interrupt (CINTS) 
Called to exit the Exec after an interrupt 
Called to exit the Exec after a system trap 
Called to enter the Exec from a privileged task 


Contains code for the system ‘idle loop' 


DSR Allocation Routines (CORAL) 


SALOCB 
SALCLK 
SDECLK 
SALPKT 
SDEPKT 
SDEACB 


Contains routines used to allocate space in DSR 


Allocates a block of specified size from DSR 
Allocates a clock queue control block from DSR 
Deallocates a clock queue control block 
Allocates a 'send' or I/O request block 
Deallocates a 'send' or I/O request block 
Deallocates a block 
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EXECUTIVE MODULES 


I/O Related Routines (IOSUB) 


e Contains routines used in I/O-related processing 


SGTPKT - Gets I/O packet from I/O queue 
SGSPKT - Gets I/O packet 
SIODON - Handles common I/O completion 


PLAS Routines (PLSUB) 


e Contains subroutines used to manipulate Program Logical 
Address Space (PLAS) 


SSRNAM - Searches for specified partition 

SCKACC - Checks if desired access to region is allowed 
SCRATT - Creates Attachment Descriptor Block (ADB) 
SSRATT - Searches for specified ADB 

SSRWND - Searches for specified address window 

SUNMAP - Unmaps address window 


Queue Manipulation Routines (QUEUE) 
e Contains subroutines used to manipulate queues 


SCLINS - Inserts an entry into the clock queue 

SCLRMV - Removes an entry from the clock queue 

SQINSF - Inserts into FIFO queue 

SQINSP - Inserts into priority queue 

SQMCRL — Queues MCR command line 

SQRMVF - Removes from front of queue 

SQRMVT - Removes next entry with specified TCB address 
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EXECUTIVE MODULES 


Task Request Related Routines (REQSB) 


SABCTK 
SABTSK 
SBILDS 
SACTTK 
SSETCR 
SSETF 

SDASTT 
SQASTT 
SSRAST 
SSRSTD 
SACTRM 
SSTPCT 
SSTPTK 
SRLPAR 
SRLPRI 
SNXTSK 
SFNDSP 
STSTCP 
SICHKP 
SCHKPT 
SLOADT 
STSKRT 
SMAPTK 


Contains subroutines used to handle task requests 


Aborts current task 
Aborts specified task 


Sets up task stack and initialize task header 


Puts task in Active Task List (ATL) 
Sets conditional scheduling request 
Sets event flag 

Declares a non-I/O related AST 

Queues an AST to a Specified task 
Searches for specified type of AST 
Searches STD for specified task 

Removes task from ATL 

Stops current task 

Stops specified task 

Releases task partition 

Releases specified partition 

Assigns next task to partition 

Finds space in system controlled partitions 
Tests if checkpoint should be initiated 
Initiates checkpoint of specified task 
Checkpoint task 

Puts task in loader queue 

Requests task execution 

Maps task address window 


SST Service Routines (SSTSR) 


SEMSST 
SILINS 
SIOTRP 
SSGFLT 
STRACE 
STRPQ4 
SSSTXT 


Contains routines to service Synchronous System Traps (SST) 


Non-RSX EMT instruction 

Illegal or reserved instruction 

IOT instruction 

Memory protect violation 

T-bit trap or BPT instruction 

Odd address, Non-existent memory, etc. 
Common SST exit routine 
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EXECUTIVE MODULES 


Time Dependent Scheduling (TDSCH) 
e Contains routines to handle time dependent scheduling 


e Entered from clock interrupt 


Updates system time and date 

Manages clock queue 

Checks for device timeouts 

Manages Round Robin scheduling 
Manages Executive level disk swapping 


System Initialization (INITL) 
e Executes only for system which has not been saved 


Contains the Executive transfer address location (SINITL) 


e Performs system initialization functions 


Writes load device and image file information into SYSCM 
Initializes Processor Status Word 

Initializes Memory Management registers (Mapped system) 
Turns on memory management hardware (Mapped system) 
Initializes Unibus Mapping Registers (11/44, 11/798) 
Calculates size of physical memory 

Verifies the existence of the external directive commons 
Verifies the presence of the floating point processor 
Verifies the presence of EIS 

Verifies that all selected devices are online 

Verifies the presence of the watchdog timer 

Sets up system clock 


@e Deallocates its space to DSR 


@e Values initialized by INITL are written to system image by SAV 
task 
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EXECUTIVE MODULES 


Table 3-1 Executive Modules by Function 


Function Modules 

Scheduling 

Task Scheduling TDSCH -— Time-Dependent Scheduling 
SYSXT - Normal Scheduling 

Round Robin Scheduling TDSCH 

Disk-Swapping TDSCH 

Idle Loop | SYSXT- 


Interrupt Processing 


Clock Interrupts TDSCH 
I/O Interrupts XXDRV - 'XX' Indicates Device 
system Entrance SYSXT 
System Exit SYSXT 


Trap Processing 


Synchronous System Traps SSTSR 


"EMT' Traps DRSUB 

DRDSP 
'TRAP' Traps DRSUB 

DRDSP 
System Entrance SYSXT 
System Exit SYSXT 
Context Switching SYSXT 
Data Movement BFCTL 
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Table 3-1 Executive Modules by Function (Cont) 


Function Modules 


DSR Allocation 


For Clock Queue CORAL 
For FIFO Queues CORAL 
For Priority Queues CORAL 
For CLI Messages CORAL 
For Error Messages ERROR 
Error Logging ERROR 


I/O Processing 


I/O Parameter Block IOSUB 
UMR Allocation IOSUB 
I/O Completion IOSUB 
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EXECUTIVE MODULES 


DIRECTIVE MODULES 


Resident Directive Module (DRSUB) 
e Contains entry points for routines entered by system traps 


STRTRP - Handles TRAP instruction 
SEMTRP — Handles EMT instruction 


e Contains commonly used routines 
SELGEF - Eliminates Group Global Event Flag block 
SDEAGF - Deaccesses group global event flags 
SDRDSE - Declares significant event 
SDRWSE - Waits for Significant event 
SMPXC1 - Maps the first directive common 
SMPXC2 - Maps the second directive common 
SDRORQ - Queues an I/O request and calls driver 
SGTUCB -—- Gets UCB address for given device and unit 
SOTHR1 - Calls directive routine in second directive 
common 
Directive Dispatcher (DRDSP) 
e Contains code to process EMT traps 
e Determines if EMT is 
Directive call 


Switch to Kernel mode 


Non-RSX EMT instruction 


e Contains table defining directives in system 
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ABRTS 
ALTPS 
ALUNS 
ASTXSS 
ATRGS 
CINTS 
CLEFS 
CMKTS 
CNCTS 
CRAWS 
CRGFS 
CRRGS$ 
CSROQS 
DECLSS 
DSARSS 
DSCPSS 
DTRGS 
ELAWS 
ELGFS 
EMSTS 
ENARSS 
ENCPSS 
EXIFS 
EXITSS 
EXSTS 
EXTKS 
GcCcIS 
GCIIS 
GLUNS 
GMCRS 
GMCXS 
GPRTS 
GREG$ 
GSSWSS 
GTIMS 
GTSKS 
MAPS 
MRKTS 
QIOS 
QIows 
RCSTS 
RCVD$ 
RCVX$ 
RDAFS 
RDXFS 


EXECUTIVE MODULES 


Table 3-2 Directive Processing Modules 


Entry 


$DRABO 
SDRAP1 
SDRASG 
SDRAXT 
SDRATR 
SDRCIN 
SDRCEF 
$SDRCMS 
SDRCNC 
SDRCRW 
SDRCRE 
SDRCRR 
SDRCSR 
SDRDSE 
SDRDAR 
SDRDCP 
SDRDTR 
SDRELW 
SDRELE 
SDREMS 
SDREAR 
SDRECP 
SDREIF 
SDREXT 
SDREXS 
SDREXP 
SDRGCL 
SDRCLI 
SDRGLI 
SDRGCL 
SDRGMX 
SDRGPP 
SDRGPP 
SDRGSS 
SDRGTP 
SDRGTK 
SDRMAP 
SDRMKT 
SDRQIO 
SDRQIO 
SDRRCS 
SDRREC 
SDRREC 
SDRRAF 
SDRRAF 


Module 


DRABO 
DRATP 
DRASG 
DRATX 
DRREG 
DRCIN 
DRSED 
DRCMT 
DRS PW 
DRMAP 
DRGEF 
DRREG 
DRCMT 
DRSUB 
DRDAR 
DRDCP 
DRREG 
DRMAP 
DRGEF 
DRS PW 
DRDAR 
DRDCP 
DREIF 
DREIF 
DRS PW 
DRE XP 
DRGCL 
DRCLI 
DRGLI 
DRGCL 
DRMAP 
DRGPP 
DRGPP 
DRGSS 
DRGTP 
DRGTK 
DRMAP 
DRMKT 
DRQIO 
DRQIO 
DRRAS 
DRRAS 
DRRAS 
DRRES 
DRRES 


Function 


Abort Task 

Alter Priority 

Assign LUN 

AST Service Exit 

Attach Region 

Connect to Interrupt Vector 
Clear Event Flag 

Cancel Mark Time Requests 
Connect 

Create Address Window 
Create Group Global Event Flags 
Create Region 

Cancel Time Based Requests 
Declare Significant Event 
Disable AST Recognition 
Disable Checkpointing 
Detach Region 

Eliminate Address Window 
Eliminate Group Global Event Flags 
Emit Status 

Enable AST Recognition 
Enable Checkpointing 

Exit If . 

Task Exit 

Exit With Status 

Extend Task 

Get command for command interpreter 
Get command interpreter information 
Get LUN Information 

Get MCR Command Line 

Get Mapping Context 

Get Partition Parameters 
Get Region Parameters 

Get Sense Switches 

Get Time Parameters 

Get Task Parameters 

Map Address Window 

Mark Time 

Queue I/O Request 

Queue I/O Request and Wait 
Receive Data or Stop 
Receive Data 

Receive Data or Exit 

Read All Event Flags 

Read Extended Event Flags 
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RPOIS 
ROSTS 
RREFS 
RSUMS 
RUNS 

SCAAS 
SCLIS 
SDATS 
SDRCS$ 
SDRPS 


SETFS 
SFPAS 
SMSG$ 
SPNDSS 
SPRAS 
SPWNS 
SRDAS 
SREAS 
SREFS$ 
SRRAS 
STLOS 
STOPSS 
STSES 
SVDBS 
SVTKS 
ULGFS$ 
UMAPS 
USTPS 
WSIGSS 
WTLOS 
WTSES 


Entry 


SDRREQ 
SDRREQ 
SDRRRF 
SDRRES 
$DRRUN 
SDRCLI 
SDRCLI 
SDRSND 
SDRSRC 
SDRSRC 


SDRSEF 
SDRFEX 
SDRSMG 
SDRSPN 
SDRPUT 
SDRREQ 
SDRRCV 
SDRREX 
SDRSRF 
SDRRRA 
SDRSTL 
SDRSTP 
SDRSTS 
SDRSDV 
SDRSTV 
SDRELE 
SDRUNM 
SDRUNS 
SDRWSE 
SDRWFL 
SDRWEFS 


EXECUTIVE MODULES 


Module 


DRSPW 
DRS PW 
DRMAP 
DRRES 
DRMKT 
DRCLI 
DRCLI 
DRRAS 
DRS PW 
DRS PW 


DRSED 
DRPUT 
DRSMG 
DRRES 
DRPUT 
DRSPW 
DRPUT 
DRPUT 
DRMAP 
DRPUT 
DRSED 
DRRES 
DRSED 
DRSST 
DRSST 
DRCMT 
DRMAP 
DRRES 
DRSUB 
DRSED 
DRSED 


Table 3-2 Directive Processing Modules (Cont) 


Function 


Request and pass offspring information 
Request Task 

Receive By Reference 

Resume Task 

Run Task 

Specify command arrival AST 

Set command line interpreter 

Send Data 

Send, Request, and Connect 

Send data request and pass offspring 
control block 

Set Event Flag 

Specify Floating Point AST 

Send message 

Suspend 
Specify 
Spawn 
Specify Receive Data AST 

Specify Requested Exit AST 

Send By Reference 

Specify Receive-By-Reference AST 

Stop for Logical OR of Event Flags 
Stop 

Stop for Single Event Flag 

Specify SST Vector Table for Debugging 
Specify SST Vector Table for Task 
Unlock group global event flags 

Unmap Address Window 

Unstop Task 

Wait for Significant Event 

Wait for Logical OR of Event Flags 
Wait for Single Event Flag 


Power Recovery AST 
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EXECUTIVE MODULES 


DEVICE DRIVER MODULES 


System Device Tables (SYSTB) 


e Contains DCBs, UCBs and SCBs, for devices with resident data 
bases. 


e Data bases for standard drivers are contained in SYSTB. 


e User can include other device data bases in SYSTB at SYSGEN. 


RKOS5S Driver (DKDRV) 
e Device driver for RK@5 disk drives. 
e Contains code for performing I/O to device. 


e Interrupts from RK@5 drive cause entry into DKDRV at S$DKINT 
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Table 3-3 


Driver 
DKDRV 
DMDRV 
DBDRV 
DRDRV 
DLDRV 
LPDRV 
TTDRV 
MMDRV 
MTDRV 
MSDRV 
DTDRV 
DXDRV 
DYDRV 
DDDRV 
DSDRV 
PPDRV 
PRDRV 
CTDRV 
DFDRV 
DPDRV 


LKDRV 


EXECUTIVE MODULES 


Standard Device Drivers 


Device 


RK@5 


RKG6, 
RP@4, 
RMG@2, 


RL#1, 


Line 


Disk Drives 

RK@7 Disk Drives 

RP@5,RP@6 Disk Drives 
RM@3,RMO05,RPO7,RM8@ Disk Drives 
RL@2 Disk Drives 


Printer. 


Terminal 


TU1O, 


TUDO, 


TS@4 
TC1l 
RX91 
RXG2 


TU58 


R883, 


TE16,TU45,TU77 Magnetic Tape 
TE16,TS@3,TM11 Magnetic Tape 
Magnetic Tape 

DECtape 

Floppy Disk Drive 

Floppy Disk Drive 

Disk Cartridge 


RS@4 Disk Drives 


Paper Tape Punch 


Paper Tape Reader 


TAI1I1 
RS88 


RP@2 


Cassette Tape 
Fixed Head Disk Drive 


Disk Drive 


KMC-11 Line Printer, Controller 
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FILE SYSTEM OVERVIEW 


FILE SYSTEM OVERVIEW 


INTRODUCTION 


This module introduces the FILES-11 system. FILES-11 
consists of an on-disk and in-memory data structure. The on-disk 
is the same for a number of related operating systems (i.e., IAS, 
RSX-11D, etc.). The in-memory structure is RSX-11M specific. 
This structure is a cache of information which improves’ the 
performance of the file system. 


OBJECTIVES 


1. Describe the on-disk and in-memory structures of the FILES-11 
system. 


2. Describe the directory structure used in FILES-ll. 


3. Describe how files are accessed on a FILES-11 volume. 


RESOURCES 


1. RSX-11M/M-Plus I/O Operations Reference Manual 
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FILE SYSTEM OVERVIEW 


CONCEPTS 

FILES-11 

e Method of organizing data on mass-storage media 

@e Common to: RSX-11M/M-PLUS, RSX-11D, IAS, TRAX, VMS 


File system includes: 


File processing software such as FCS or RMS 


Provides easy interface between user program 
system 


and file 


Allows access data by means of user-defined records 


Executive code to handle queued I/O requests 
Result of QIO directive 
Provides synchronization of I/O operations 


Determines if I/O operation is file-oriented 


A device driver to handle primitive I/0 operations 
Data transfers between the device and memory 

An ancillary control processor, ACP, which 

file-related I/O operations 


Possible conversion to driver operations 


A FILES-11 volume may be: 


Any kind of disk (including floppy disks) 


DECtape 
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performs 


FILE SYSTEM OVERVIEW 


PRIVILEGED | NON-PRIVILEGED 
| 


USER 1/0 
REQUEST 


FCS/RMS 


DEVICE- 
INDEPENDENT Seve 
alo Hid DEPENDENT 
DIRECTIVE DIRECTIVE 
USER STATE 


SYSTEM STATE 


Qio 
DIRECTIVE 
SERVICE 


EXECUTIVE 
1/0 
SUBROUTINES 


DEVICE INTERRUPT —> 


1/0 
DRIVER 


Figure 4-1 The File System 
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FILE SYSTEM OVERVIEW 


Files 
Three units of measurement of space on media: 
e Physical blocks 
Physically addressable unit 
Length dependent on type of media 
Usually 512 bytes 
RX81 - 128 bytes 
RX@2 - 128 or 256 bytes 


Normally referenced by device driver 


@e Logical blocks 
Length equal to 512 bytes 
Block numbers unique for volume 
Begins at logical block @ 
Highest logical block equals volume size minus one 


Normally referenced by the file processor (F11ACP) 


@e Virtual blocks 
Used by programmer to access data in files 
Length always equal to 512 bytes 
Virtual block numbers relative to file 
Begins at virtual block 1 


Highest virtual block equals file size 
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FILE SYSTEM OVERVIEW 


Files consist of two parts: 

e The File Header 

e The File Body 

The File Header 

e Contains description of file 
File name 
File owner 


File characteristics used by FCS and RMS 
Information for mapping virtual blocks to logical blocks 


e Usually one block long (512. bytes); size depends on_ the 
file processor in use 


The File Body 


e Contains data stored by user and any control data appended by 
the file access method 


e Consists of a number of contiguous groups of logical blocks 
(segments) 
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FILE SYSTEM OVERVIEW 


FILE HEADER BLOCK 


OFFSETS TO IDENTIFICATION 
AND MAP AREAS 


FILE ID 


FILE OWNERSHIP AND PROTECTION HEADER AREA 
INFORMATION 


FILE CHARACTERISTICS 
SIZE (BYTES) OF HEADER AREA 


FILE NAME, TYPE AND VERSION 


DATES OF CREATION AND 
(DISK REVISION IDENTIFICATION AREA 


BLOCK SIZE (BYTES) OF IDENTIFICATION 
256 WORDS) AREA 


MAPPING INFORMATION 
RETRIEVAL POINTERS MAP AREA 
CHECKSUM WORD 


Figure 4-2 The File Header 
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FILE SYSTEM OVERVIEW 


Dome af DRESS CSOS»30647INTROL.MODS24 ~- File ID 7450+460%0 
File header 


HEATER AREA 
He. TOF 027 
HH. MPOF 056 
HF NUM» 
H.FSEQ (7450%60) 
HeFLEYV 401 
H.FOWN L305» 306] 
H.~FFRO CRWETyRWE De RWEDe RI 
HeUCHA 000 = 
H.SCHA 000 = 
H.UFAT 
F.RTYF O02 = R.VAR 
FsRATT @0O2 = Fr.CrR 
F.RSTIZ 102 = &464. 
F.HIBK HiO L2£000013 
F.EFBK Hi0 Li00001% 
F.FFBY 310 = 200. 
CREST) 
000000 000000 000000 000000 000000 000006 000000 000000 
000000 
TYENTIFICATION AREA 
I.FNAMs 
I.FTYF 
I.FVER INTROL «MOTE 2656 
I. RVNOQ &é 
IT. RVOT 14-0EC-81 
C.RYVTI O2250322 
I,.CRIOT 15-OCT-81 
I.,CRTI O92 446739 
IT.-EXOT ine 
MAF AREA 
M.ESQN YOO 
Me ERVUN 000 
Ms«EFNU » 
M.EFSQ (OrG) 
M.CTSZ OO] 
M.LESZ 00% 
M.USE O02 = 2. 
M.»MAX 314 = 204. 
M-RTRY 
SIZE LRN 
Li. HiGOL Li1é6S7S1 = 125929, 
CHECKSUM 
He CKSM 1234624 


11. 
li. 


HoH 


Example 4-1 The File Header for a Data File 
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FILE SYSTEM OVERVIEW 


Yiume of DBEICSOS»3S0617SFPY.TSKS16 ~- File IU) 161042759 
File header 


HEALER AREA 
H. TDOF 027 
MH. MPOF O54 
H. FNUM » 
H»FSEQ (1610497) 
He FLEY 401 | 
H»FOWN 3053081 
H«FPRO CRWEDy RWEDy RWED»y Re 
H.UCHA 200 = UC.CON 
H.SCHA 000 = 
He UFAT 
ELRTYF O01 = R.FIX 
F.RATT 000 = 
F.RSIZ 1000 = 512. 
F.,HIEK HO Ltooooso = 4 
E.EFBK Hi0 Li000051 = 41. 
F.FFEY 0 = 0. 
(REST) 
000000 000600 000000 000000 600000 CGO000 o0GaGE 000000 
000000 
TUENTIFICATION AREA 
I-+FNAM» 
LF TYE» 
TF VER SPY »TSKE1S 
1+ RYNO 20 
I. RVET 14-DEC-81 
I.RVTI 02250328 
I.CRIT O5-JUN-S1. 
I.CRTI 14214233 
Te EXDT =a 
MAF AREA 
MESON 000 
NM. ERVN 000 
MeEFNUs 
N-EFSQ (090) 
M.CTSZ O01 
MeLESZ O03 
MUSE 002 = 2, 
Me MAX 314 = 204, 
MeRTRY 
SIZE LEN 
AQ. HiOO1 L$172544 = 128356. 
CHECKSUM 
H.SKSM 133471 


Example 4-2 The File Header for a Task Image 
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FILE SYSTEM OVERVIEW 


Retrieval Pointers 
e Defines the correspondence between logical and virtual blocks 
e Contained in the file header: 

Maximum: 102 per header 

One fragment per retrieval pointer 


Maximum file length with 1 block per header: 26112 blocks 
e Four bytes long 


One byte: number of virtual blocks in segment; maximum 
is 256 blocks. 


Three bytes: pointer to first logical block in segment. 


NO. BLOCKS - 1 


STARTING LBN 


(1,3) RETRIEVAL POINTER 


Figure 4-3 Retrieval Pointer 
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FILE SYSTEM OVERVIEW 


FILE HEADER 


FILE BODY 
VBN LBN 
2 301 
~ 3 302 
RETRIEVAL) | 1 | 


POINTERS 


Fa 


Figure 4-4 Mapping Virtual to Logical Blocks 
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FILE SYSTEM OVERVIEW 


File Directories 


Contains information needed to identify and locate files 
File name, type and version number 


File number (Relative number of file headers’ in 
file) 


index 


File sequence number (Number of times a file header is 


used) 


Two types of directories 


Master File Directory (MFD) -- One per volume. 


User File Directory (UFD) -- As many as desired per volume 


Naming convention 
Name of directory: xxxyyy.DIR;1l 
where 


XXX iS a group number 
yyy is a member number 


Master File Directory: Q@@@800@.DIR;1 


User File Directory for UIC: [6,32]: 096032.DIR;1 


FILENAME 
(RAD50O) 


On oa Aa WD = 


Figure 4-5 Directory Record 


8B 


| FILE ID 
FILE SEQUENCE NO. 


FILE TYPE (RADSO) 
FILE VERSION 


FILE SYSTEM OVERVIEW 


FILES-11 VOLUMES 


The Standard Files 

e The Index File: INDEXF.SYS 

e The Bitmap File: BITMAP.SYS 

e The Master File Riese eoey: GOGGGO.DIR 
e The Bad Block File: BADBLK.SYS 


e The System Checkpoint File: CORIMG.SYS 
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FILE SYSTEM OVERVIEW 


The Index File 


Contains basic structures needed by file system. 


Boot Block 

Home Block 

Index File Bitmap 
All File Headers 


Filespec: [@,@]INDEXF.SYS;l, 
File ID/SEQ: 1/1 


Boot Block 


Contains bootstrap code for hardware booting of device 
Always virtual block 1 of index file 

Always logical block @ of volume 

Written by SAV command when the /WB switch is used 

If volume not bootable, contains code to print’ the 


message: THIS VOLUME DOES NOT CONTAIN A HARDWARE BOOTABLE 
SYSTEM 


Home Block 


Contains information needed by file system to access data 
on volume 


Volume label 

Pointer to index file bitmap 

Size of index file bitmap 

Checksum words to validate data in home block 
Always located in virtual block 2 of index file 


Located in first good block in sequence 
1, 488, 10900, 1400, ...... 


Checksum used to identify homeblock 
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FILE SYSTEM OVERVIEW 


e Index File Bitmap 
Allows fast access to unused blocks in index file 
Always located beginning in virtual block 3 of index file 
One bit per possible file header in index file 
Bit is set to indicate if block is in use 
Bit clear if block is free 


Bit is set if block is in use 


e File Headers 


Contained in virtual blocks starting at block 3+n, where n 
is the length of the bitmap 


First 16 headers are contiguous 
Virtual block of header = 2+m+t+on 
where 


n 
m 


number of blocks in index file bitmap 
file number 
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FILE SYSTEM OVERVIEW 


VBN LBN 
1 BOOT BLOCK 0 


2 HOME BLOCK 1 OR 400 OR 1000... 
INDEX BIT MAP 
3 O=FREE 
1=USED 
34N INDEX N IS SIZE OF INDEX 
FILE HEADER BITMAP (NO. BLOCKS) 
STORAGE BIT MAP 
sa, FILE HEADER 
BAD BLOCK 
wae FILE HEADER 
6+N MASTER FILE DIRECTORY 
FILE HEADER 
7+N CORE IMAGE CHECKPOINT 
FILE HEADER 


8+N USER FILE DIRECTORY 
FILE HEADER 
e 


Figure 4-6 Structure of the Index File 


FILE SYSTEM OVERVIEW 


The Bitmap File 


e Virtual block number 1 contains allocation information used on 
RSX-11D 


e Bitmap starts in virtual block number 2 of the bitmap file 

@e One bit per logical block on volume 

@ Value of each bit indicates status of corresponding block 
Bit set - block not allocated to file 


Bit clear - block allocated 


e VFY compares clear bits with retrieval pointers 


e Filespec: [8,8] BITMAP.SYS;1l, 
File ID/SEQ: 2/2 


WORD O WORD 1 
LBN 15 LBN O LBN 16 
LBN 31 


Figure 4-7 The Bitmap File 
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The Master File Directory 
e Directory corresponding to UFD [8,98] 
e Contains entries for the five standard files 
e Contains entries for all UFDs on volume 
e Contains entry for system account file RSX11.SYS 
e Filespec: [@,0@] @088080.DIR;1, 
File ID/SEQ: 4/4 
The Badblock File 
e Used to keep bad blocks from being allocated to user files 


e Bad block information created by BAD or entered by the user or 
manufacturer allocates blocks to file 


e Filespec: [@,@]BADBLK.SYS;1l, File ID/SEQ: 3/3 


e No dynamic badblock handling 


INDEXF || BITMAP |} BADBLK || 000000 || CORIMG ee 
SYS SYS SYS DIR SYS 
FILE MAC FILE OBJ FILE TSK 


Figure 4-8 Two Level Directory Structure 
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The System Checkpoint File 


Used to checkpoint tasks 

No space allocated when volume initialized 
Space allocated by ACS command 

Always contiguous 


Filespec: [@,@®]CORIMG.SYS;1, 
File ID/SEQ: 5/5 
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FUNCTIONS OF THE FILE SYSTEM 


Creating a FILES-11 Volume 
e FILES-11 volume created by INITIALIZE command 
@e Home block information can be modified by the HOME command 
e Creates five standard files 
@ Volume characteristics determined: 
Volume label 
Number of blocks for default file extension 


Size of index file (number of blocks used for file 
headers) 


Number of files on volume 
Location of index file 


Default protection for files on volume 
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FILE SYSTEM OVERVIEW 


Creating a File 
e Index file bitmap searched for first free block 
e First free block used for file header 


e Bitmap file searched for required number of free blocks’ to 
allocate initial file 


e Entry for new file placed in UFD 


CREATE 
DIRECTORY 
ENTRY 


ALLOCATE 
BLOCKS TO 
FILE BODY 


MAP VIRTUAL 
TO LOGICAL 
BLOCKS 


CREATE 
FILE 
HEADER 


USE INDEX USE BITMAP 


FILE BITMAP apenas FILE TO stalls 
TO ALLOCATE h LOCATE UNUSED 
HEADER UFD BLOCKS POINTERS 


SET UP FILE 


INITIALIZE 
ID IN 


HEADER 


FILE HEADER 


Figure 4-9 Creating a File 
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Accessing a File 
e By file name - DB1:[181,1@1]DATA.DAT;1 


MFD from device mounted on _ DBI: is searched for 
191101.DIR 


File ID for 191191.DIR is used to find the file header 
Retrieval pointers from header are used find UFD file 
UFD is searched for entry for DATA.DAT 

File ID for DATA.DAT is used to find the file header 
Retrieval pointers from header are used to find file 


File is accessed 


® If file ID is known, file header can be accessed without using 
directories 


INDEX FILE 
VBN 


4 INDEX FILE HEADER 


5 BITMAP FILE HEADER 


MFD ID,SEQ,O UFD [101,101] 


A.FTN;1 0,5, 
DATA.DAT;1 11,1, 


6 | BADBLOCK FILE HEADER 


INDEXF.SYS;1 1,1,0 
BITMAP.SYS;1 2,2,0 
BADBLK.SYS;1 3,3,0 
000000.DIR;1 4,4,0 
CORIMG.DIR; 1 5,5,0 
001001.DIR;1 6,1,0 
200200.DIR;1 7,1,0 
005006.DIR;1 0,3,0 
101101.DIR;1 


¢) 
e) 


: MFD FILE HEADER 


10 CORIMG FILE HEADER 


11 UFD |1,1] HEADER 


12 | UFD [200,200] HEADER 


13 | UFD [101,101] HEADER 
DATA.DAT;1 


14 DATA.DAT;1 HEADER USER FILE DATA 


Figure 4-18 Accessing a File 
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FILE SYSTEM OVERVIEW 


THE FILE PROCESSOR 


File Control Processors 


Privileged system task which handles file-specific I/0 
Processes QIO commands queued to its receive queue 
Several file processors supplied with system 

FILIACP - Used for FILES-11 disk volumes 

MTAACP — Used for magnetic tape volumes 


NETACP - Used by DECNET 


To speed up file operations, dedicate appropriate FCPxxn 
volumes 


>INS $FCPxxx/TASK=DB1FCP 


>MOU DK%:/ACP=DB1FCP 
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Logical Units 


Tasks specify I/O devices by using logical unit numbers. 
Each logical unit number refers to a unique I/O device. 
Pointer to an entry of the logical unit table for the task. 
The logical unit table is in the task header. 
Each entry is two words long: 

Word one is a pointer to the UCB for the device. 

Word two is a pointer to a FILES-11 window block if file 


is open; and @ otherwise. 


FILES-11 window block is a data structure used to store 
retrieval pointers. 


Logical unit table constructed = and units assigned at 
taskbuild. 


Logical unit asSignments can be changed by: 
REASSIGN command 


ALUNS directive 


OZ 


FILE SYSTEM OVERVIEW 


TASK HEADER 


POINTER TO UCB 


LOGICAL 
UNIT 
TABLE 


Figure 4-11 The Logical Unit Table 
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Data Structures 
e The Volume Control Block (VCB) 
Created from information in home block 
One VCB per mounted volume 
Contains 
Transaction count for volume 
Logical block number of index file bitmap 


Logical block number of storage bitmap 
Pointers to other data structures, e.g. FCB 


e The File Control Block (FCB) 
Created from file header 
One FCB per open file 
Contains 
Logical block number of file header 


File number and sequence numbers 
File owner and protection code 


e FILES-11 Window Block 
One window block per accessor to file 


Contains 


Access privileges of accessor 
Retrieval pointers (seven by default) 


NOTE 
Retrieval pointers in the file header use one 
byte for the block count and three bytes for 
the disk address; those in the window block 
use two bytes for the count and four bytes 
for the disk address. 
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VOLUME TRANSACTION COUNT 
VOL. CHARACTERISTICS VOLUME TYPE 


V.TRCT 
V.TYPE 
V.LABL 


V.VCHA 


V.PKSR 


V.IFWI 
V.FCB 


LISTHEAD 


Figure 4-12 The Volume Control Block 
(Part One) 
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V.IBSZ V.IBLB 
V.SBSZ 
V.FIEX V.SBLB 
BITMAP FILE LBN 
NUMBER OF FREE BLOCKS ON VOLUME = 


V.EXT 


RESERVED FOR FUTURE USE 


Figure 4-12 The Volume Control Block 
(Part Two) 
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FFOWN 
. FILE HEADER F.HDLB 
a ~ LOGICAL BLOCK NUMBER _ 7 
LOGICAL BLOCK NUMBER OF VIRTUAL BLOCK 1 F.LBN 


OF CONTIGUOUS FILE (0 OTHERWISE) 


SIZE OF FILE 


IN BLOCKS 


STARTING VIRTUAL BLOCK NUMBER F.FVBN 


OF THIS FILE SEGMENT 


POINTER TO LOCKED BLOCK LIST 
WINDOW BLOCK LIST 


Figure 4-13 The File Control Block 


F.NLCK F.SIZE 


F.LKL 
F.WIN 
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FILE SYSTEM OVERVIEW 


[resenves | cour 
[—saeorwncow 


W.WISZ 


BLOCK MAPPED BY WINDOW 


NUMBER OF BLOCKS MAPPED - 1 W.RTRV 
1ST RETRIEVAL 
1ST PHYSICAL B 
i gui POINTER 


MAPPED BY POINTER 


NUMBER OF BLOCKS MAPPED - 1 


2ND RETRIEVAL 
1ST PHYSICAL BLOCK 
Ss ey, Ge es oo ee ee ee jee POINTER 
MAPPED BY POINTER 


Figure 4-14 FILES-11 Window Block 
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Mounting a Volume 
e Volume mounted by MOUNT command 


Compares the volume label with that specified in the MOUNT 
command 


Copies homeblock information into VCB 


Associates an ACP with the volume 


e Steps in mounting a FILES-11 volume: 
Volume Control Block is created 
VCB is linked from the UCB uSing U.VCB 


Index file is opened 


IN MEMORY ON DISK 


INDEX FILE 
WINDOW 


VCB 
V.IFWI 
V.FCB 


MFD HEADER | 


F.HDLB 


MFD 


TCB 
XXXACP 


Figure 4-15 Mounting a Volume 
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FILE SYSTEM OVERVIEW 


Opening a File 


Steps in opening a file: 


File Control Block or FCB is created. 
FILES-11 window block is created for file. 
FCB is inserted in the FCB queue for volume. 


Pointer from logical unit table to window block is 
initialized. 


Shared files have only one FCB but separate window blocks. 


File system keeps, in memory, a list of FCBs of the more 
recently used directories. 


This list is called the LRU. 


Eliminates need to read directories from disk when file is 
accessed. 


Least recently used directory is flushed when new 
directory accessed if list is full. 


Size of LRU list is determined by LRU switch on INI or HOM 
command. 
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FCB. _ FCB FCB 
INDEX 
FILE ee 


WINDOW BLOCK 


INDEX 
FILE 


LUT ENTRY 
FILACP 


WINDOW BLOCK 


Figure 4-16 Opening a File 
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SYSTB VCB 


FCB FCB FCB FCB 
INDEX USER 


WINDOW 
BLOCK 


UCB FOR 
DKO: 


INDEX 
FILE 


TASK HEADER 
TASK A WINDOW 


BLOCK 


USER 
FILE 


TASK HEADER 


TASK B WINDOW 


BLOCK 


USER 
FILE 


Figure 4-17 Shared Access 
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SYSTEM GENERATION 


INTRODUCTION 


The RSX-11M operating system is designed to support a large 
variety of application environments and possible hardware 
configurations available to the PDP-1ll processor. The process 


used to adapt the system to these varied conditions is called 
System Generation or SYSGEN. 


The RSX-11M SYSGEN procedure is designed to allow customizing 
of the operating system to be performed in an efficient and 
accurate manner. The procedure iS run under the control of 
Supplied indirect command files. Facilities such as VMR and SAV 
are provided to help the user set up his system quickly. 


OBJECTIVES 


1. Generate a functioning RSX-11M system. 


2. Perform the ancillary functions, VMR and SAV, to produce a 
practical system. 


RESOURCES 


1. RSX-11M System Generation and Management Guide 
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SYSTEM GENERATION 


OVERVIEW 


SYSGEN Functions 
e Provide support for existing hardware 
The processor model (e.g., PDP-11/44) 


Processor options (e.g., memory management, floating-point 
processor) 


Devices installed on system 
Number of controllers and physical units 


Vector and CSR addresses for all devices 


@e Provide needed software features 
Executive options (e.g., directives, 'round-robin') 
File system (version of F11ACP) 
Resident library support (e.g., FCPRES) 


Terminal support (e.g., full-duplex) 
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The SYSGEN Process 


SYSGEN procedure is contained in three indirect command files 


SYSGEN.CMD - First phase of SYSGEN 


Assembles Executive 
Assembles device drivers 


Creates command files to be used in phase two 


SYSGEN2.CMD - Second phase of SYSGEN 
Taskbuilds the Executive 
Taskbuilds the device drivers 
Creates needed libraries 
Taskbuilds the privileged system tasks 
SYSGEN3.CMD - Third phase of SYSGEN 


Allows system tasks to be rebuilt 


Between phase two and phase three, VMR should be 
the new system 


Use VMR command file SYSVMR.CMD created by 
procedure 


Can be edited to add desired partitions 

Must be edited if system is unmapped 
Configure the new system 

Set up partitions 


Load device drivers 
Install system tasks 


SYSGEN procedure creates saved answer file SYSSAVED.DAT 


applied to 


the 


SYSGEN 


Contains answers to SYSGEN questions in symbolic form 


File can be modified by user for use in later SYSGEN 
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Types of SYSGEN 


e SYSGEN can be performed using the base-line system on the 
distribution kit 


Called a standalone SYSGEN 


System is dedicated to SYSGEN, no other users 


e SYSGEN can be performed using an existing RSX-11M system 
Called an on-line SYSGEN 
Other users can use the system during most of the SYSGEN 
process 

e MCR commands can be inhibited during the SYSGEN process 
Called a PREPGEN 


Saved answer file can be corrected/modified for use later 
in live SYSGEN 
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New Features for Version 4.0 
e Autoconfigure option determines correct hardware configuration 
Processor type 


CSR and vector addresses 


e Standard feature Executive option produces a mapped system 
Most software options 


Supports all layered products 


@e Improved saved answer file support 
Saves responses to Phase II questions 
Supports named input and output saved answer files 


Can create a single saved answer file for Phase I and II 


@e A minimum of 28K words of memory is required for SYSGEN 

e Directive commons increase POOL size 

e Taskbuild .CMD and .ODL files are dynamically created 

e <A PLAS overlaid FCS resident library may be selected 

e Either EDI or EDT may be selected for editing SYSGEN files 


e Phase I can chain to Phase II without a break 
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PREPARING FOR SYSGEN 


Distribution Kits 
e There are several different kits available 


"Big Disk' distribution kit for RP@4/05/06/87, RM22/03/95, 
RM8@ and RA8@ 


RK#6/@7 distribution kit 
RL@1/@2 distribution kit 


RK@5 distribution kit 


e Distribution kit must be copied before SYSGEN using DSC 


Version 3.2 DSC cannot be used unless V 4.9 patch has been 
applied (see release notes) 


Copy of standalone DSC supplied with kit can be used 


Autopatch 


e A collection of patches to the released system 
Issued at regular intervals 
Also may include patches to layered products 
e Must always be applied to released version without revious 
patches 


e Uses an indirect command file to generate patched system 
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SYSTEM GENERATION 


Individual Patches 

e Patching source files 
Used for Executive, driver and MCR patches 
Use Source Language Input Program (SLP) 


Create SLP command file 
Invoke SLP with command file 


For MACRO-11 sources, output for SLP must be: 
Assembled 
Task-built 
Integrated into system (Method depends on component 
patched) 
Patching object files 
Used for patching utilities 
Use Object Module Patch Utility (PAT) 
Create MACRO-11 source file for correction 
Assemble correction file 
Apply correction to old object file using PAT 
Output from PAT must be: 


Task-built 
Reinstalled into the system 


e Patching task image files 
Infrequently used for operating system patches 
Frequently used for patching layered products 
Use Task/File Patch Program (ZAP) 


Create ZAP command file 
Invoke ZAP to apply patches to task image file 


e Patches supplied by DIGITAL are cumulative 


Apply a patch only if you have already applied all 
previous patches 


Unless the patch states otherwise, apply patch to most 
recent version of the component 
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DETAILS OF SYSGEN 


Phase 1 


There are seven sections in Phase 1 
Setup - How SYSGEN is to be run 


Target Configuration -—- The environment for which the 
SYSGEN is being performed 


Host Configuration —- The system on which SYSGEN is 
being run 


Executive Options - What features are deSired in the new 
system 


Terminal Driver - Which type of terminal driver and which 
features are desired 


System Options - Which file processor, CLI support, and 
POOL monitoring support is desired 


Peripheral Options - Specification of devices, controllers 
and their vectors, and CSRs 


After questions have been anSwered, the Executive and drivers 
are assembled 
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Phase 2 
There are eight sections in Phase 2 
Setup - How SYSGEN Phase 2 is to be run 
Library Commons Creation - Modifies SYSLIB, creates other 
libraries used in taskbuilding 


system tasks 


Executive Taskbuild - Creates system images RSX11M.TSK, 
EXCOM1.TSK and EXCOM2.TSK 


System Image Creation - Creates RSX11M.SYS from RSX11M.TSK 
Full-Duplex Terminal Driver Taskbuild - Creates the full- 
duplex driver if 


selected 


Loadable Driver Taskbuild - Creates all drivers not built 
into the Executive 


Privileged Task Taskbuild - Builds privileged system tasks 


System VMR - Modifies RSX11M.SYS, creating partitions, 
installing tasks, etc. 
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Phase 3 
e Optional - May be performed when and as often as desired 
e Used to build optional tasks not included in distribution kit 
e Used to rebuild supplied tasks to: 
Change defaults 


Incorporate support for ANSI magtape and/or FCS 
big-buffering 


Use a resident FCS library 
e Used to rebuild tasks after patching 


e VMR must be used to remove and install new versions of tasks 
installed in the system image 
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EXECUTIVE OPTIONS 


Standard Feature Executive 


Allows the generation of a system supporting all 
features 


Requires a mapped system 
Provides the following: 


DBMS-11 support 

FILES-11 ACP support 

RMS support 

Nonresident task support 
Loadable task loader 
Directive commons 

Memory management directives 
All other Executive directives 
Address checking support 

I/O rundown support 

Multiuser support 

ANSI Magtape support 

Loadable driver support 

AST support 

28K word Executive 

Error logging 

Powerfail recovery 

User written driver support 
System controlled partitions 
Round-robin scheduler and disk swapping 
Software write lock support 
Queue manager 

Shuffler 

Crash dump support 
Full-duplex terminal driver 
DCL and two user written CLIs 
POOL monitoring 

PLAS resident FCS 

"MIDDLE' F11ACP 
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The Terminal Driver 


Two possible terminal drivers: 


Half-duplex driver 
Full-duplex driver 


Half-duplex driver comes in three forms: 


The 


The 


The 


The 


Full-duplex driver requires a mapped system with 
driver support 


Baseline 
Tailored 
Tailorable 


baseline half-duplex driver 


Minimum terminal driver 
Not available with multiuser systems 


tailored half-duplex driver features include: 


Automatic carriage/line feed 
Write with CTRL/O cancellation 
Breakthrough write 

CTRL/R rewrite 

Get multiple characteristics 
Get terminal driver options 
Read after prompt 

Read with no echo 

Read with special terminator 
CRT rubout support 

User terminal input buffering 


tailorable driver allows selection of all 


terminal options 


full-duplex driver includes: 


Task checkpoint during input 

Passes form feeds directly to the terminal 
Supports unsolicited input character AST 
Executive AST support) 

Hold screen mode 

LA3@P support 

Device independent cursor positioning 


possible 


(requires 


Plus features included in the tailored half-duplex driver 
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SYSTEM GENERATION 


Choosing a File Processor 


e Several different versions of FIL1ACP available 


e Versions differ in amount of overlaying and in number of 
internal buffers 


e See discussion in module 'I/O Processing' for descriptions of 
available ACPS 
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USING VMR 


Overview of VMR 
e Can perform many of the same tasks as MCR 
Define partitions 
Load drivers 


Install tasks 


e Commands operate on system image file 


e Used to perform system initialization for needed features 


Set up partitions 
Load standard drivers 


Install system tasks and utilities 
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On a Mapped System 


e SYSGEN generates a VMR command file which should be edited _ to 
produce the system desired 


e All needed partitions are defined 
Driver partition 
Directive commons 
All leftover space goes in GEN 
e Commands for partitions needed by application tasks must be 
added to the command file 
e All DEC-supplied drivers are loaded 


e All important system tasks are installed 


321400 
FCPPAR 275400 


FCSRES 242700 
SYSPAR 232600 


DRVPAR 
206200 


TTPAR 146200 
LDRPAR 143400 


poo. 134500 
oe 120000 


EXECUTIVE 


Figure 5-1 Partition Structure on Mapped Systems 
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On an Unmapped System 
e Modification of SYSVMR.CMD recommended on unmapped system 


It is not possible for SYSVMR.CMD to create an optimal 
partition structure 


e For unmapped 16K to 24K systems, VMR: 
Creates partition GEN and installs all tasks into it 


Length is always 49999 bytes 


Creates partition SYSPAR 
Length is 1906 bytes if FCPMIN chosen 
Length is 1200 bytes if FCPSML chosen 
Creates partition SPLPAR if PRT chosen 


Length is 19498 bytes 


e For unmapped 24K to 28K systems, VMR: 
Creates partition GEN and installs all tasks into it 
Length is always 4@8@@ bytes 
Creates partition SYSPAR 
Length is 1998 bytes if FCPMIN chosen 


Length is 120@ bytes if FCPSML chosen 


Creates partition PAR14K 


Length is 78888 bytes 


Creates partition SPLPAR if PRT selected 


Length is 18488 bytes 
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SPLPAR 
SYSPAR 
130000 
PAR 14K 100000 
40000 


EXECUTIVE 


Figure 5-2 Partition Structure on Unmapped 24K to 28K Systems 


SYSTEM GENERATION 


SPLPAR 
SYSPAR 


EXECUTIVE 


100000 


40000 


O 


Figure 5-3 Partition Structure on Unmapped 16K to 24K Systems 
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SAVING THE NEW SYSTEM 


e Copies the current system image into the system image file 
from which the system was booted 
e Used to make a system hardware bootable 
e System must be saved before compressed by DSC or BRU 
e Requirements for saving a system 
SAV must run from CO: 
Error logging is not active 
All tasks are installed from LB: 
No checkpoint files are active 
No volumes are mounted except the load device 
The load device can be successfully dismounted 
No tasks have outstanding I/O 
No task is connected to interrupts 
All drivers, active tasks and fixed tasks reside within 
the saved area of memory 
e Saving a system 
Lowest part of memory copied into buffer in SAV task 
Secondary bootstrap program loaded into low memory 
Special driver used to load system to and from disk 
Cannot use interrupts 


Same special drivers used by SAV and BOOT 
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SYSTEM GENERATION 


Can create a bootstrap program within the volume bootblock 
Reads in first block in system image file 
Transfers control to secondary bootstrap in block just 
loaded into memory 

Before writing system image to disk, converts logical 


block number in TCB into file ID 


When system booted, file IDs in TCBs converted back into 
- logical block number 


SPECIAL DRIVER 


BUFFER FOR LOW MEMORY 


SAVE 
TASK 


2010 


SYSTEM IMAGE SPECIAL DRIVER 


BOOTSTRAP 


Figure 5-4 Saved System Image 
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PHYSICAL AND VIRTUAL MEMORY 


INTRODUCTION 


The most important resource managed by an operating system is 


physical memory. To manage memory, an operating system must 
define subdivisions of memory, allocate space to tasks, and 
optimize memory use. This module examines the data structures 


used to perform these tasks. 

Since the PDP-ll uses 16-bit words, only 32K words of 
physical memory can be addressed unless’ some form of address 
relocation is provided. On the PDP-1l, the KT-11 memory 


management hardware provides the mechanism for relocation. This 
module also explains the hardware and processing used. 


OBJECTIVES 


1. Diagram the data structures used by the Executive to control 
physical memory. 


2. List the steps in checkpointing a task. 


3. Describe the memory management hardware. 


129 


PHYSICAL AND VIRTUAL MEMORY 


CONCEPTS 


Physical Addresses 


e A contiguous series of word addressable hardware locations 


@ Defines main memory and peripheral device registers 


Virtual Addresses 
e Set of addresses uSed within a task 
e Program counter is a 16-bit register 


User task can reference addresses between @ and 
octal 


Virtual addresses are local to a task 


Unmapped Systems 

@e 32K words of addressing space 

e Maximum physical memory is 28K words 

@e Programs built for specific memory location 


e No memory protection 
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177777 
160000 


1/0 PAGE| 


32K 
28K WORDS 
WORDS 


EXECUTIVE 
(20K WORDS 


MAXIMUM) 
000000 


Figure 6-1 Typical Unmapped System 
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PHYSICAL AND VIRTUAL MEMORY 


Mapped Systems 


e KT-11 hardware is present 


Two types of mapped systems 


18-bit addresses 
128K words of addressing space 


124K words of physical memory 


22-bit addresses 
2@48K words of addressing space 
192@K words of physical memory 


e 16-bit virtual address converted to 18- or 22-bit physical 
addresses 


® Virtual addresses range from @ to 32767 


e Relocation and memory protection provided 
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ee 1/O PAGE 
reoooo | __——VO PAGE 
128K 
124K WORDS 
WORDS 
EXECUTIVE 
(20K WORDS 

MAXIMUM) 

000000 


Figure 6-2 Typical Mapped System with 18-bit Addressing 
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17777777 
17760000 | I/O PAGE 
Meee ey UNIBUS MAPPING 
REGISTERS 
16760000 (124K WORDS) 
EXECUTIVE 
(20K WORDS 
| MAXIMUM) 
00000000 


1920K 
WORDS 


2048K 
WORDS 


Figure 6-3 Typical Mapped System with 22-bit Addressing 
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MEMORY MANAGEMENT 


Overview 


e Basic functions 
Perform memory relocation/mapping 


Provide extended memory addressing capability 


e Task is mapped in pages 
Page length is from 1 to 128 memory blocks 


Memory block is 32 words in length (1898 octal bytes) 
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Memory Management Hardware 


Several sets of relocation registers: Active Page Registers 
(APRs) 


Each APR consists of two 16-bit words 


Page Address Register (PAR) 
Contains a physical memory address in units of 32 
words memory blocks 
Used to relocate 4K words of virtual memory (one page) 


Page Descriptor Register (PDR) 
Contains the size of the virtual memory block to be 
relocated 
Provides control of access rights 


Every mapped system contains at least two sets of eight APRs 
KERNEL Mode APRS 
USER Mode APRs 


Larger processors have more APRs 
APRs for KERNEL and USER mode Instruction and Data space 
Supervisor mode Instruction and Data space APRS 


The Processor Status Word (PS) determines the APRs in use 


Four memory management registers (MMR@, MMR1, MMR2, and MMR3) 
control processor use of memory management 


MMR@ - Error flags 
Page number whose reference caused error 
Other status flags 


MMR1 - Only on 11/44 and 11/78 
Records any autoincrement/decrement of 
general purpose registers 


MMR2 - The Virtual Address Program Counter 


MMR3 - Only on 11/44 and 11/70 
Enables/disables 
Use of D space APRs 
22-bit mapping 
UNIBUS mapping 
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1§ 14 13 12 1110 9 8 7 6 5 4 3 2 1 #0 


Peedi Se ed UE 


_ —_ —_—_— 
ABORT-NON RESIDENT 

ABORT-PAGE } 

LENGTH ERROR 

ABORT-READ ONLY } 

ACCESS VIOLATION 

TRAP-MEMORY MANAGEMENT 

NOT USED 

NOT USED 

ENABLE MEMORY MANAGEMENT TRAP 
MAINTENANCE MODE 

INSTRUCTION COMPLETED 

PAGE MODE 

PAGE ADDRESS SPACE 1/0 


PAGE NUMBER 
ENABLE RELOCATION 


MEMORY MANAGEMENT REGISTER #0 (MMRO) 


15 11 10 8 7 3 2 0 


AMOUNT CHANGED REGISTER AMOUNT CHANGED REGISTER 
(2'S COMPLEMENT) NUMBER (2'S COMPLEMENT) NUMBER 


MEMORY MANAGEMENT REGISTER #1 (MMR1) 


15 6 5 4 3 2 1 0 
CEL Le Jers 
17772516 


ENABLE 22-BIT MAPPING 
KERNEL 
SUPERVISOR 
USER 


MEMORY MANAGEMENT REGISTER #3 (MMR3) 


Figure 6-4 Registers Used by Memory Management 
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15 0 


PAGE ADDRESS FIELD (PAF) 


THE PAGE ADDRESS REGISTER 
APR 


15 14 8 


7 6 5 4 3 2 1 +90 
[ [rasetenemnecun [a[w] [em] cr] 


THE PAGE DESCRIPTOR REGISTER 


ACF - ACCESS CONTROL FIELD 
ED - EXPANSION DIRECTION 


wie ACCESS INFORMATION BITS 
PLF - PAGE LENGTH FIELD 


Figure 6-5 Active Page Registers 


PAR 


PHYSICAL AND VIRTUAL MEMORY 


PHYSICAL MEMORY 


4K WORDS | 473400 


VIRTUAL 

NUMBER ADDRESSES PARs 453400 

7 160000-177777 [ 002300 (a 

6  140000-157777 | 002100 A WORBS aoasaG 

5 120000-137777 | 000000 oF 

4  100000-117777 | __000166 Wes 

3 060000-077777 | 000000 ve “i ue ne 

2  040000-057777 | 003242 |[/x* 

1 020000-037777 | 004734 4 210000 

0 000000-017777 [ 004534 


4K WORDS | 16600 


Figure 6-6 Page Address Registers 
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PHYSICAL AND VIRTUAL MEMORY 


Software Use of Memory Management 
e RSX-11M uses KERNEL and USER instruction space APRs 
e KERNEL APRs are loaded so that 


APRs @ through 3 or 4 point to Executive code and data 


4 APRs for 16K word Executives 
5 APRs for 28K word Executives 


APR 7 points to the I/O page 


Other APRs are dynamically mapped as needed 


e User tasks are mapped using USER APRs 
If task does not map to the Executive 


APRs are used consecutively starting at APR @ 


If task maps to the Executive 
APRs @ through 3 or 4 are the same as the KERNEL 
APRs @ through 3 or 4 
APR 7 points to the I/O page 


Other USER APRs are used to map the user task 
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LIBRARY 
Seay 6K 
(NON-POSITION 
USER PARs 00542200 | INDEPENDENT) ORR 
s | -aossas > << a 
4 000000 00400000 INDEPENDENT] WORDS 
3 000000 
2 | 
1 
'@) 
12K 
WORDS 


00254200 


Figure 6-7 Use of Memory Management by a Nonprivileged Task 
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{ 207800 - 16-BIT 
007600 - 18-BIT 
{ 207800; 22-BIT 


4K 
eae 
KERNEL PARs 
7, CY 
6 | 000000 
5 {| 000000 
4, kk 
3} 000600 | 
2} 000400 |\ 
4K WORDS 
1 000200 \ | 4K WORDS | 
O 0000 
20K 
16K WORD WORDS 


EXECUTIVE 


OOO0O000 - 16K EXECUTIVE 
001000 - 20K EXECUTIVE 


Figure 6-8 Use of Memory Management by the Executive 
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OeNnNWAWO N 


KERNEL 


COPIED FROM USER PARs 


PHYSICAL AND VIRTUAL MEMORY 


I/O PAGE 


PRIVILEGED 


EXECUTIVE 


WHEN TASK SWITCHES TO KERNEL MODE 


Figure 6-9 


Use of Memory Management by a Privileged Task 
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PHYSICAL AND VIRTUAL MEMORY 


ALLOCATING PHYSICAL MEMORY 


Partitions 
Task Partitions 

@® Controlled by user 

e May be divided into subpartitions 


e May be built to run in main partition or in one of the 
subpartitions 


e Controlled by busy word P.BUSY in the PCB of the main partiton 


Common Partitions 
e Used for shared data or code 
e Linked to task statically by taskbuilder or dynamically by 
using memory management directives 
Device Partitions 
e Pseudo-areas whose addresses overlay the I/0 page 


e Allow nonprivileged tasks to access the I/O page 


System-Controlled Partitions 


e Used to hold executable tasks, device drivers, and dynamic 
regions 


@e Space allocated as needed by the Executive 


e Tasks loaded into dynamically created subpartitions 
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PCB OF PCB OF 1ST PCB OF 2ND PCB OF 3RD 
MAIN PARTITION SUBPARTITION SUBPARTITION SUBPARTITION 


01010000] 10000000 |P BUSY 01000000] 0 1000000/P.BUSY 00000000] 00 100000 |P.BUSY 


SSS SS OS 


MAIN PARTITION 1ST SUBPARTITION 2ND SUBPARTITION 3RD SUBPARTITION 
NOT BUSY BUSY NOT BUSY BUSY 


Figure 6-18 Subpartitions of a Task Partition 
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PHYSICAL AND VIRTUAL MEMORY 


The Partition Wait Queue 


Linked list of TCBs of tasks waiting for space in partition 
Ordered by descending task priority 


When TCB is placed in wait queue of system controlled 
partition, subpartition PCB is created but not linked to 


partition list 


First task in queue is allocated space before others 
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T.LNK=0 


WAIT QUEUE OF A 
USER CONTROLLED 
MAIN PARTITION 
WITH ONE 
SUBPARTITION 


nh 
— 


P.LNK 
MAIN WAIT QUEUE OF A SYSTEM 
a: CONTROLLED PARTITION 
WITH ONE TASK 

—_—e ALREADY RESIDENT 

P.LNK=? 

P.SUB=0 TCB'S OF WAITING TASKS ARE CHAINED ACCORDING 
| P.MAIN | TO THE RUNNING PRIORITY OF THE TASKS IN 


DESCENDING ORDER 


Figure 6-ll The Partition Wait Queue 
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PHYSICAL AND VIRTUAL MEMORY 


USING PHYSICAL MEMORY 


Loading Tasks 


Task TCB placed in loader queue after space allocated 
Loading performed by loader task, LOADR 


Loader task uSes loader queue to decide which task to _ load 
next 


Utility link word, T.LNK, used to link TCBs in queue 


Location T.RCVL in the loader TCB is the queue listhead 


Steps in loading: 


Executive places TCB of task to be loaded in the loader 
queue (LOADRS receive queue) 


Executive unstops the loader 
Loader scans queue and loads task 


When queue is empty, loader calls SSTPCT to stop itself 
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Checkpointing 
e Task is copied from memory to space on a disk volume 
Allows a higher priority task to execute 


Copied either to a reserved area in task image file or to 
a system checkpoint file 


Reserved area only used if system checkpoint files are 
full 
e Steps in checkpointing a task 
Test to see if task should be checkpointed 
Initiate the checkpoint operation 
Allocate checkpoint space and write the task to disk 


TEST IF TASK SHOULD 
BE CHECKPOINTED 


INITIATE 
CHECKPOINT 


WAIT FOR 
1/0 
COMPLETION 


DON'T 
CHECKPOINT 
TASK 


ALLOCATE SPACE 
IN SYSTEM 
CHECKPOINT FILE 


NO NO SET RUN CHECKPOINT 
T2.CAF TKTN TASK 


YES YES 


PLACE TCB 
IN LOADER 
QUEUE 


UNSTOP 
LOADER 


Figure 6-12 Steps in Checkpointing a Task 
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POINTER TO NEXT CHECKPOINT PCB O P.LNK 
UCB ADDRESS OF CHECKPOINT DEVICE 2 P.PRI 
4 P.NAM 
LBN OF CHECKPOINT FILE 
6 


CHECKPOINT PARTITION CONTROL BLOCK 


Figure 6-13 System Checkpoint Files: The Checkpoint PCB 


S$CFLPT > 


PHYSICAL AND VIRTUAL MEMORY 


CHECKPOINT FILE 
WITH 2 CHECKPOINTED 
TASKS IN IT 


P.LNK=0 
oe) 
P.SUB=0 


CHECKPOINT FILE 
CURRENTLY NOT USED 


Figure 6-13 System Checkpoint Files: PCB Linkages 
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PHYSICAL AND VIRTUAL MEMORY 


Shuffling 
e Consolidates holes in a system-controlled partition 
e Shuffling performed by shuffler task - SHUFL 


e Performed in two passes over a system-controlled partition 


Shuffler Pass One 


e Partition list searched, from S$PARHD, for system-controlled 
partition 


e If task is in wait queue of system-controlled partition, 
shuffle operation is initiated 


e Shuffle operation: 
Find next hole (first?) 
Find region following hole 
Determine if region is shufflable 


If shufflable, checkpointable and stopped, or blocked by 
MCR BLOCK command, task is checkpointed 


If shufflable, move region and contents to bottom of hole 


When all regions have been shuffled, invoke SNXTSK_ to 
reallocate space 


e Nonshufflable regions 
Loaded device drivers 
Tasks connected to interrupt vectors 
Tasks fixed for parity errors 


Tasks with long outstanding I/O (did not complete in 1/2 
second) 


Dynamic regions 


If nonshufflable region is found, next hole is found and 
process continues 


e If pass one completes and the partition wait queue is not 
empty, paSS two is invoked. 
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Shuffler Pass Two 


e Attempts to gain space by finding a contiguous sequence of 
holes and lower priority checkpointable tasks 


e Checkpoint operations initiated by calls to SICHKP 


e When checkpointing is complete, pass one is rerun 


BEFORE AFTER 
SHUFFLING SHUFFLING 
SYSTEM 
CONTROLLED | SMUFFLASLE 
PARTITION 


SHUFFLABLE 
TASK 


FREE 


NON-SHUFFLABLE 
TASK 


SHUFFLABLE 


TASK FREE 


SHUFFLABLE 


SHUFFLABLE 
TASK 


- 
> 
” 
A 


Figure 6-14 Shuffling Tasks 
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USING VIRTUAL MEMORY 


Attaching 
e Makes region available to attaching task 
e Steps in attaching to a region: 
An Attachment Descriptor Block (ADB) is created 


ADB is linked to the PCB for the region using A.PCB in the 
ADB, and P.ATT in the PCB | 


ADB is linked to the TCB for the task using A.TCB in the 
ADB, and T.ATT in the TCB 


ADB is linked into the ADB list for the partition using 
A.PCBL in the ADB . 


ADB is linked into the ADB list for the task using A.TCBL 
in the ADB 


PCB ATTACHMENT QUEUE THREAD WORD 


O A.PCBL 


ATTACHMENT DESCRIPTOR BLOCK 


BIT | MASK 


| 3 | 10 | AS.DEL - TASK HAS DELETE ACCESS (1=YES) 
| 2 | 4 | AS.EXT - TASK HAS EXTEND ACCESS (1=YES) 
| 4 | 2. | AS.WRT - TASK HAS WRITE ACCESS (1=YES) 
| 0 | 4 | AS.RED - TASK HAS READ ACCESS (1=YES) 


ATTACHMENT DESCRIPTOR STATUS BITS 


Figure 6-15 The Attachment Descriptor Block 
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ad 
a ara; 
TASK ADB 
HEADER 


CREATED 
REGION 


WINDOW 
BLOCK O 
WINDOW 
BLOCK 1 


Figure 6-16 Attaching a Task to a Region 
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PHYSICAL AND VIRTUAL MEMORY 


Mapping 


Task virtual address window block contains information needed 
to load APRs to allow access to physical region 


Task is mapped to a region if a window block contains’ the 
needed access information for the region 


Pointers to the PCB and ADB for the region 
High and low virtual address limits for the region 


Window size and offset in the physical region in 32 word 
blocks 


Number of APRS needed for the window and PDR information 
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POINTER TO NUMBER OF WINDOW BLOCKS H.WND 


NUMBER OF WINDOW BLOCKS 


PCB ADDRESS W.BPCB 
"LOW VIRTUAL ADDRESS LIMIT |: W.BLVR 
~ HIGH VIRTUAL ADDRESS LIMIT | W.BHVR 
wow) [[__ soenmonis | waar 
BLOCK 0 WINDOW SIZE (32 WORD BLOCKS) W.BSIZ 
OFFSET INTO PARTITION (32 WORD BLOCKS) | W.BOFF 
NUMBER OF PORs ' FIRST PDR ADDRESS | W.BNPD/W.BFPD 
CONTENTS OF LASTPDR———S—S=*&Y:sSW<GBBLPD 
WINDOW 
BLOCK 1 


Figure 6-17 Task Virtual Address Window Blocks 
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TASK 
HEADER 


WINDOW 
BLOCK 0 
WINDOW 
BLOCK 1 


Figure 6-18 
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CREATED 
REGION 


Mapping a Task Address Window to a Region 
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TASK MANAGEMENT 


INTRODUCTION 


The basic unit of executable code under RSX-11M is the task. 
Most tasks are user written, but some are system-Supplied, such as 
the task-loader, MCR, etc. The Executive must manage the task 
scheduling and allocate needed resources to requesting tasks. 
This module describes the techniques used to manage tasks. 


OBJECTIVES 


1. Describe the content and functions of the task label blocks 
and task header. 


2. Diagram the data structures used to manage task scheduling. 


3. Describe the process of task termination. 


RESOURCES 


1. RSX-11M System List and Data Structures 


2. RSX-11M/M-PLUS Executive Reference Manual 
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TASK MANAGEMENT 


THE TASK IMAGE 


The Task Image File 


The 


Created by the taskbuilder 


Includes: label block group, checkpoint area (optional), task 
header, and task image 


Label Block Group 
Label block @ 
Task and resident library data 


Used to set up TCB and task addressing windows in header 


Label block 1 
Table of LUN assignments for LUN 1 through LUN 128 


Used to create Logical Unit Table(LUT) in header 


Label block 2 


Continuation of Table of LUN assignments for LUN 129 
through LUN 255 (if needed) 


Used to create LUT in header 


Label block 3 
Segment load list (optional) 


Resident libraries that contain memory resident overlays 


The Checkpoint Area 


Used to provide checkpoint space when no space available in 
the system checkpoint files 


Size equal to size of header plus the task image 
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LABEL BLOCK O - TASK AND 
RESIDENT LIBRARY DATA 


LABEL BLOCK 1 - TABLE OF 
LUN ASSIGNMENTS 


LABEL BLOCK 2 - TABLE OF 
LUN ASSIGNMENTS (OPTIONAL) 


LABEL BLOCK 3 - SEGMENT 
LOAD LIST (OPTIONAL) 


TASK HEADER - 
FIXED PART 
TASK HEADER - 
VARIABLE PART 
ROOT SEGMENT 
(CONTIGUOUS BLOCKS) 


SEGMENT TABLE 


AUTOLOAD VECTOR 
REGION DESCRIPTOR 
WINDOW DESCRIPTORS 
SEGMENT DESCRIPTORS 


LABEL BLOCK 
GROUP 


CHECK POINT 
AREA 


TASK HEADER 


TASK IMAGE 


OVERLAY SEGMENTS 
(TASK-RESIDENT 
OVERLAY DATA BASE) 


Figure 7-1 Task Image File 
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The Task Header 


Consists of two parts: fixed and variable 
Fixed part contains 
Event Flag mask word and address 
Initial values for PS, PC and SP 


Low-Core context: S$DSW, and inpure storage area addresses 
for FCS, FORTRAN, etc. 


Pointers to specific areas within the variable part 


Variable part contains 
Window blocks 
Logical unit table 


Task context 


Window Block 
Describes task mapping 
Associates window with region 
Contains pointer to PCBs of regions used by task 
Pointers loaded at task installation 
Used to load APRs for task 


Initialized when task is installed 


Logical Unit Table 


Contains a two word entry for each logical unit used by 
the task 


Word one: address of the UCB of the device assigned 
to the logical unit (UCB address loaded at task 
installation) 


Word two: address of the FILES-11 window block of an 
open file 
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The Task Image 


e Task code 
e Overlay information 
Autoload vectors 
Region and window descriptors for memory-resident overlays 


Segment descriptors 


40 H.EFSV 
42 H.FPSA 
44 H.WND 
46 H.DSW 


50 H.FCS 
52 H.FORT }LOW-CORE 


CONTEXT 
TASK HEADER - ADDRESS OF OVERLAY IMPURE STORAGE | 54 H.OVLY 
FIXED PART ADDRESS OF IMPURE VECTORS 56 H.VEXT 
MAILBOX LUN | SWAPPING PRIORITY 60 H.SPRI/H.NML 
aGIRBLE PEAT UNUSED 
VARIABLE PART 
RESERVED 64 
RESERVED 66 
RESERVED 70 
HEADER GUARD WORD POINTER 72 H.GARD 
NUMBER OF LUNS 74 H.NLUN 


Figure 7-2 The Task Header: Fixed Part 
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H.LUN | LUN TABLE (2 WORDS PER LUN) 
NUMBER OF WINDOW BLOCKS 
PARTITION CONTROL BLOCK ADDRESS 
LOW VIRTUAL ADDRESS LIMIT 


HIGH VIRTUAL ADDRESS LIMIT 


ADDRESS OF ATTACHMENT DESCRIPTOR 


WINDOW SIZE (IN 32-WORD BLOCKS) aa 
OFFSET INTO PARTITION (IN 32-WORD BLOCKS) 
NUMBER OF PDRS TO MAP| FIRST PDR ADDRESS 


CONTENTS OF LAST PDR 


OFFSETS 
W.BPCB 

W.BLVR 

W.BHVR 

W.BATT 

W.BSIZ 

W.BOFF 
W.BNPD/W.BFPD 
W.BLPD 


Figure 7-2 The Task Header: Beginning of Variable Part 


INITIAL VALUES 

IDENT. WORD #2 

TASK NAME WORD #2 

TASK NAME WORD #1 

[HEADER GUARD WORD[ 


Figure 7-2 The Task Header: End of Variable Part 
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RUNNING A TASK 


TASK MANAGEMENT 


e Performed by MCR RUN command 


Directives 


RUNS 


ROSTS 
SPWNS 


e If task not 
Task is 
Task is 


Task is 


installed, use MCR command 
installed with name equal to terminal, TTnn 
executed 


removed on exit 


e Two types of requests: 


Immediate request - is executed aS soon as possible 


Time-dependent request 


Executed at a specified time 


Rescheduled to run periodically 


e Steps in running a task 


Task is 


installed 


Task is activated 


Memory is allocated to task 


Task is loaded 


Task is scheduled 


Task is terminated 


TASK MANAGEMENT 


Installing 
e Task is installed by MCR command 
Permanent installation by INS command 


Temporary installation by RUN command 


e TCB is created and initialized 
e Location T.PCB in TCB points to: 


The PCB of the partition or sSubpartition for which it was 
built (if partition is user-controlled) 


The PCB of the main partition (Li partition is 
system-controlled) 
e Locations T.LDV and T.LBN point to the load device and logical 
block number of the task image file 


e Access rights to resident commons and libraries are checked 


e Task TCB is inserted into the STD by routine SQINSP in module 
QUEUE 


e Window blocks in header are initialized from the label blocks 


e LUT is initialized from the label blocks and UCB addresses are 
loaded 
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TASK MANAGEMENT 


Activating 
e Task placed in the Active Task List (ATL) 
e If task not installed and not privileged, it is 
installed 
Allocating Memory 
® Partition wait-queue used to schedule memory use 
Ordered by task priority 
Linked using T.LNK, the utility link word 


Starts at P.WAIT in PCB 


e TCB placed in partition wait-queue 
When task is requested 


When task is checkpointed 


Loading 
e Task placed in loader queue 
Utility link word, T.LNK, links TCBs in queue 


Location P.WAIT in PCB is queue listhead 


e In mapped system, task header copied into DSR 
Executive updates copy in DSR 


SDSW only data in task copy that is updated 


Lie 


temporarily 


TASK MANAGEMENT 


TCB OF 
LOADER 
TASK 


TCB’S OF TASKS TO BE LOADED OR ROLLED OUT/IN 
ARE CHAINED ACCORDING TO THE RUNNING PRIORITY 
OF THE TASKS IN DESCENDING ORDER. 


TS.CKP TS.OUT 
INVALID 


INITIAL LOAD 
CHECKPOINT WRITE 
CHECKPOINT READ 


LOADER QUEUE 


TK-1813 


Figure 7-3 The Loader Queue 
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Context Switching 
e Current task's context stored in task header 
e Task context includes: 

General registers (R@ —- R5) 

Processor Status Word 

Stack pointer (R6) 

Program counter (R7) 


Floating-point registers 


e Mapping context for current task is not saved 


e New task's context is loaded from its header 


e Mapping context for new task created uSing window blocks 
PCBs 
GPRs 
NEW 
TASK 
PS 
a SNS 
OLD 
APRs DSR 
| | 
| EXEC 
CODE 
SAVING CONTEXT 


Figure 7-4 Context Switching: Saving Context 
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and 


TASK MANAGEMENT 


new 
[ict CTS 
| WINDOW BLOCKS — 
PS 
ae 
OLD 
aie TASK 
enn) 
EXEC 
| rrrrrrts—C——C“(‘(;._CdT «sf GOODE 
LOADING CONTEXT 


Figure 7-4 Context Switching: Loading Context 


a Wy ge) 


TASK: MANAGEMENT 


PCB FOR 
GEN 


UCB 


WINDOW BLOCK 0 


IN MEMORY 


Figure 7-5 The Data Structures for an Active Task 
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SCHEDULING A TASK 


Priority 

e Scheduling request sets value in $RQSCH 

e Value can be: 
The beginning of the ATL (e.g., after a significant event) 
Address of particular TCB (e.g., after a conditional 
scheduling request) 

e Scheduling algorithm scans the ATL beginning at the TCB’ whose 

address is in $RQSCH 
e System chooses: 


First resident unblocked task 


First task with a pending AST 


Round Robin 


Tasks of the same priority share the CPU 
Is a SYSGEN option 
Parameters set at SYSGEN 

Round robin scheduling time interval 


Priority range for round robin 


For each priority in priority range 
Sublist of tasks of that priority is scanned 
TCBs of blocked, suspended or waiting tasks are skipped 


TCB of first eligible task is placed last in list of tasks 
with same priority 
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TASK X 


(BLOCKED) 


PRIORITY = 100 


INTERVAL #1 


PRIORITY =50 


TASK Y 
PRIORITY =30 


Figure 7-6 Round Robin Scheduling: Interval #1 
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TASK MANAGEMENT 


TASK X 
(BLOCKED) 
PRIORITY=100 


TASK B 
(BLOCKED) 


PRIORITY =50 INTERVAL #2 


TASK E 
(BLOCKED) 


TASK Y 
PRIORITY =30 


Figure 7-6 Round Robin Scheduling: Interval #2 
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TASK MANAGEMENT 


Disk Swapping 


Allows tasks of similar priority to share memory 
Is a SYSGEN option 


Parameters set at SYSGEN 


Swapping priority 


Time interval for swapping 


Steps in disk swapping 


When task loaded, swapping priority is set at H.SPRI in 
the task header 


At the end of each swapping interval, H.SPRI is 
decremented 


H.SPRI is not decremented beyond the negative of the 
swapping priority 


For checkpointing, H.SPRI is added to the running priority 


When task is checkpointed, H.SPRI is set back to the 
swapping priority 
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TASK MANAGEMENT 


Clock Scheduling 
e Provides facility for tasks to run 
At specific times 


After specific time intervals 


e When clock interrupt occurs, the clock queue is scanned 


e Types of time dependent requests 
Mark time request 
Task request with periodic rescheduling 
Single shot task request 


Single shot internal subroutine 
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CLOCK INTERRUPT 


INCREMENT 
INTERRUP” 
COUNT 


CREATE 
FORK 
PROCESS 


UPDATE 
TIME AND 
DATE 


CLOCK 
QUEUE 
EMPTY? 


YES 


TIME 
OEPENOENT 
SCHEDULING 


OEVICE 
TIMEOUT 


Figure 7-7 Time-Dependent Scheduling 
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AST Processing 


AST is used to notify a task when an asynchronous event has 
occurred 


Three phases in processing an AST 
Specifying the AST 
Allocate an AST control block 
Fill in the type of AST at A.CBL 


Link the block to the TCB at T.SAST 


Declaring the AST 


Queue the AST control block to the AST queue at T.ASTL 


Scheduling the AST 
Conditional schedule request is made 


After context switch to task, RESCH in SYSXT attempts 
to dequeue an AST 


Stopped task is activated to process the AST, then 
stopped again 


When an AST is scheduled 


Necessary data is pushed onto the task stack 


AST executes before return to task code 
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1/0 LIST FOR 
DB@: 


CLOCK QUEUE 


CLOCK 
QUEUE 
CONTROL 

BLOCK FOR 
MARKTIME 


TCB 


T.ASTL=0 
=e 


AST 
CONTROL 
BLOCK 
FOR 
RECEIVE 
DATA 


Figure 7-8 AST Processing: Sources of ASTs 


, 
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TASK MANAGEMENT 


CLOCK QUEUE I/O LIST FOR 
DB@: 
CLOCK 
QUEUE 1/0 
CONTROL PACKET 


BLOCK FOR 
MARKTIME 


TCB ‘N 


AST 
CONTROL 
BLOCK 
FOR 
MARKTIME 


AST 


CONTROL 
BLOCK 
FOR 


RECEIVE MARKTIME EXPIRES 


DATA 


Figure 7-8 AST Processing: Marktime Expiration 
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I/O LIST FOR 
DB@: 


1/0 
PACKET 


TCB 


AST 
CONTROL 


AST 


CONTROL BLOCK 
FOR RECEIVE 
MARKTIME DATA 


AST 
CONTROL 
BLOCK 
FOR 
RECEIVE 
DATA 


DATA RECEIVED BY TASK 


Figure 7-8 AST Processing: Completion of a Receive Data 


I/O LIST FOR 
DB@: 


1,0 
PACKET 


AST 
CONTROL 
BLOCK 
FOR 
MARKTIME 


T.SAST=0 


I/O REQUEST COMPLETES 


Figure 7-8 AST Processing: Completion of an I/O Operation 
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TASK TERMINATION 


e Normal termination 


Task issues an exit directive 


e Abnormal termination 


Another task issues an abort directive 


Task is aborted by an MCR abort command 


Task is aborted because of an SST 


e Actions performed at task termination 


e I/0 


Halt task 

Cleanup system database 

Cancel mark time requests 

Break links to offspring tasks 

Disconnect interrupt vectors, if any 

If T3.REM = 1, deallocate TCB 

Deallocate header in pool if mapped system 
If abnormal exit, run TKTN 


Declare a significant event 


Rundown 
Kill all I/O on each assigned LUN 
Detach all attached devices 


Close all files opened by task 
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Synchronous System Traps 


e Trap vector for each type 


e System response to SST 


244 


Kernel mode: 


User mode: 


Crash system 
Abort task if no user SST vector 


Execute user-supplied routine if 
user SST vector 


Table 7-1 Synchronous System Traps 
Trap Service 
Routine Routine Cause 
STRP#4 STRPQA4 Odd or nonexistent memory address error 
SSGFLT $SGFLT Memory protect violation 
STRACE S$TRACE T-bit or BPT instruction 
SIOTRP SIOTRP TOT instruction 
SILINS SILINS Reserved instruction 
SEMTRP SEMSST Non-RSX EMT instruction 
STRTRP STRTRP TRAP instruction 
SFPPR8 SFPPR& Synchronous floating-point exception 
(or SFPPR7) 
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[ SST ROUTINE] 


TRAP 
AT STACK 
DEPTH=0? 


NO YES 


PROTECTED YES 
AREA IN DRDSP 
OR ORONO? 
e NO RETURN 
DIRECTIVE 
STATUS 
Y ES STACK NO 
DEPTH=0? 
ao veo Sits: > 
oe EXISTS? 
® 
SET UP STACK NO 
FOR RETURN TO 
USER SST 
ROUTINE geade 
TASK 


RETURN 


Figure 7-9 SST Processing 
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SYSTEM SYNCHRONIZATION 


INTRODUCTION 


A large number of activities are in progress at any given 
time while an RSX-11M system is in use. System synchronization is 
the term given to the system processing which keeps’ these 
activities from interfering with each other. One important 
activity which must be controlled is access to the system data 
base. 


OBJECTIVES 


1. Describe how a software trap is processed by the system. 
2. Describe how a hardware interrupt is processed by the system. 


3. Describe FORK processing. 


4. Describe how a privileged task gets access to the system data 
base and code. | 


RESOURCE 


1. RSX-11M System Lists and Data Structures 
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SYSTEM SYNCHRONIZATION 


OVERVIEW 


e Executive is driven by interrupts and traps 


Idle until interrupt or trap occurs 


e System operation 
Executive booted into memory by ROM 
ROM starts Executive by initializing PS and PC 
Executive initializes the environment 
Enables memory management unit 
Turns on clock 


Drivers called at powerfail entry points 


Fxecutive drops into idle loop and waits for interrupts 
Command typed in at a terminal 
Interrupt occurs 
Command passed to MCR or DCL 
MCR or DCL runs a task. 


Task may issue traps 


Clock may interrupt functions 
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SYSTEM SYNCHRONIZATION 


System Synchronization Functions 


e Provides serial access to system database 


Process accessing system database '‘owns' the database 
until finished 


"Race' conditions are avoided 
@e Provides orderly method of allocating CPU use between user 
and system 
Software States 
e User State 
User code executing 
Processor in USER mode 


Processor fully interruptable - Hardware priority is 8 


e System State 


Only state in which the shared system database should 
be accessed 


Processor in KERNEL mode 


Processor fully interruptable - Hardware priority is @ 


e Interrupt Service State 
Used to perform critical operations after an interrupt 
Processor in KERNEL mode 


Processor not fully interruptable - Hardware priority 
between 4 and 7 
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SYSTEM SYNCHRONIZATION 


Software Processes 


e Process - A stream of code in KERNEL mode performing a 
complete logical job 


Can be in the Executive or in a privileged task 
e There are three types of processes contained in ‘the 
Executive 
Trap process 
Services a software trap 


Performed in system state 


Interrupt Process 
Services a hardware interrupt 


Performed in interrupt service state 


FORK Process 


Allows process or task to get access to system 
database 


Performed in system state 
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SYSTEM SYNCHRONIZATION 


The Stack Depth Indicator 


One word at location $STKDP in the Executive module SYSCM 


Indicates software state and number of interrupts which 
have occurred in KERNEL mode 


Value of +1 indicates processing in user state 


Value of @ indicates processing in system or interrupt 
service state 


Trap or interrupt occurred from user state 


Negative value indicates processing in interrupt 
service state 


Trap occurred from system state 


Each time trap or interrupt occur, $STKDP is decreased by 
l 


Each time a trap or interrupt process completes, $STKDP is 
increased by 1 


Traps and Interrupts 


CPU hardware performs following steps 


New program counter and processor status are obtained 
from the vector 


Current program counter and processor status are 
pushed onto current stack 


Current stack is KERNEL stack if mapped system 
Current stack is USER stack if unmapped system 
New program counter contains address of trap_ service 


routine 


New processor status causes 


Processor to change to KERNEL mode 
Processor priority to change to level 7 
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SYSTEM 
STACK 


VECTORS 


Figure 8-1 


SYSTEM SYNCHRONIZATION 


PHYSICAL 
MEMORY 


$STACK:: 


SWITCH" 


Handling Traps and Interrupts by the Hardware 
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SYSTEM SYNCHRONIZATION 
TRAP PROCESSING 


1. Trap caused by execution of a "trap! instruction or 
synchronous system trap detected by the Executive 


2. Each type of trap corresponds to a unique two word vector in 
low memory 


3. Most common trap is ‘EMT 377', the result of a directive call 
4. EMT instructions 
Cause a transfer to location SEMTRP in module DRSUB 


Processing occurs in module SDRDSP, the Directive 
Dispatcher 


DRSUB 


SEMTRP:: 
JSR R5, $DIRSV 


MOV $XCOM1, KISARS SYSXT 
JMP $DRDSP $DIRSV:: 


@) DRDSP 


$DRDSP:: 


CALL (RS) 
BR $DIRXT 


CALL ---- $DIRXT:: 


RETURN 


RETURN 


Figure 8-2 EMT Instruction Execution 
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SYSTEM SYNCHRONIZATION 


The Directive Save Routine 

e Code begins Se Gabel SDIRSV in module SYSXT 

e Called by trap processing routine upon entry 

e Processing in directive save routine 
Stack depth indicator is decremented to @ 
R5 is saved on current stack by JSR instruction 
R4 is saved on current stack 
On unmapped system, loads R6 with pointer to system stack 
R3, R2, Rl and R@ are saved on system stack 


Performs coroutine call back to DRSUB 


The Directive Exit Routine 
e Code begins at label $DIRXT in module SYSXT 
e Raises processor priority to 7 to lock out interrupts 
e Checks for waiting FORK process 
If so: maps driver using KERNEL APR 5 
transfers control to next FORK process 
e Increments $STKDP (Should now be +1) 
e Restores general purpose registers 


e Executes RTI instruction to return to USER mode 
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SYSTEM SYNCHRONIZATION 


R4 
ONLY UNMAPPED 


SYSTEM 
DECREMENT 
$STKDP 
SAVE STACK vES —$STKDP 
POINTER =0? 
NO 
, 1 LOWER 
LOAD SYSTEM PROCESSOR 
| STACK POINTER | PRIORITY TO 0 
<< SAVE 
REGISTERS 
R3, R2, R1, RO 
COROUTINE 
CALL BACK 
TO DRSUB 


Figure 8-3 The Directive Save Routine 


SYSTEM SYNCHRONIZATION 


$DRDSP 


GET 'EMT' 
INSTRUCTION 


PROCESS TASK MAPPED 


TO EXEC? 


DIRECTIVE 


Figure 8-4 Common Processing in the Directive Dispatcher 
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SYSTEM SYNCHRONIZATION 


LOCK OUT 
INTERRUPTS 


YES NO EXECUTE 


YES FORK 
SWITCHING QUEUE FORK 
DISABLED? EMPTY? ROUTINE 


NO 


YES YES 
INITIATE RESTORE 
TASK REGISTERS RESCHEDULE 
EXIT RO, R1, R2, R3 


a ie 


| RELOAD | 
UNMAPPED INCREMENT RESTORE 
ONLY ae peices | $STKDP R4, RS 


[ 


Figure 8-5 The Directive Exit Routine 
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SYSTEM SYNCHRONIZATION 


INTERRUPT PROCESSING 


The 


Interrupt caused by hardware event 


Device driver allows interrupt by setting '‘'interrupt-enable' 
bit device register 


Each device controller has its own 2-word interrupt vector in 
low memory 


Interrupt Save Routine 
Code begins at label SINTSV in module SYSXT 


Entry is with processor priority at level 7 to lock out other 
interrupts 


Called by interrupt service routine upon entry 


Processing in interrupt save routine 


Stack depth indicator is decremented by one 
R5 is saved on the current stack by JSR R5,SINTSV 
R4 is saved on the current stack 


On unmapped system, SP is loaded with the address of the 
system stack if entry is from user mode 


Processor priority is lowered to priority of the 
interrupting device 


Performs coroutine call back to the interrupt service 
routine 


Several versions of this routine are available in module SYSXT 


SINTSV - Used by devices without error logging 
SINTSE - Used by devices with error logging 


SINTSC - Used by connect-to-interrupt routines 
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SYSTEM SYNCHRONIZATION 


LOWCR DRIVER SYSXT 


$XXINT:: (2) SINTSV:: 
JSR R5, S$INTSV 


INTERRUPT erent 


VECTOR 


Figure 8-6 Interrupt Processing 
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SYSTEM SYNCHRONIZATION 


Device Driver Processing 


The 


Usually divided into three processing sections 


Processor Status Word in vector causes entry into interrupt 
service routine at priority 7 


All interrupts are blocked 


Usually SINTSV is called and lowers priority 


Critical processing is performed at the priority of the device 


For a terminal, the last input character is processed and 
the interrupt-enable bit is set for the next character 


If the system data base must be accessed, a FORK process 
is created 


A device driver can access the system data base only as a FORK 
process 


A FORK process executes at procesSor priority @ 


interrupt Exit Routine 
Code begins at label SINTX1 in the module SYSXT 
Raises processor priority to 7 to lock out interrupts 
Checks for waiting FORK process 

If one: lowers priority to @ 


saves R@ - R3 on system stack 
executes the SDIRXT routine 


Increments SSTKDP 
Restores general registers 


Executes RTI instruction to return to USER mode 
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SYSTEM SYNCHRONIZATION 


SAVE 
R4 
DECREMENT 
$STKDP 
SAVE ES —“$STKDP 
CURRENT SP =0? 
NO 


re et‘ O 
LOAD 


: LOAD SYSTEM | DEVICE 
: STACK POINTER : PRIORITY 


SS COROUTINE 
CALL TO 
UNMAPPED DRIVER 
ONLY 


Figure 8-7 The Interrupt Save Routine 
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SYSTEM SYNCHRONIZATION 


LOCK 
INTERRUPTS 


GO TO 5$ IN [gYES_ —~ CORE 
$DIRXT MPTY 2 
NO 


ALLOW 
INTERRUPTS 


NO . |1GO TO 10$ IN 
$DIRXT 


REGISTERS 
RO, R1, R2, R3 


” 
> 
< 
mi 


Figure 8-8 The Interrupt Exit Routine 
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SYSTEM SYNCHRONIZATION 


FORK PROCESSING 


e Provides serial access to the system data base 
Processes needing access are queued 
No process gains access until the current process is 
finished with the system data base 

e Usually process is part of a device driver, but any privileged 


task can create a FORK process 


e Created by routines in module SYSXT 


SFORK - Used by device drivers 

SFORK# - Creates FORK process without saving R4 and R5 
SFORK1 - Creates FORK process saving R4 and R5 

SFORK2 - Used by connect-to-interrupt routines 


The FORK Block 

e Four word block containing 
Link word for FORK list 
Saved PC 
Saved R5 


Saved R4 


e FORK block for device driver contained in the SCB 


The FORK List 


e FORK blocks are linked into FIFO queue called FORK list 


e Begins at list head in SYSCM at location $FRKHD 


SYSTEM SYNCHRONIZATION 


SAVED R4 


KISARS 


Figure 8-9 The FORK Block in the SCB 


FORK FORK 
BLOCK BLOCK 


Figure 8-18 The FORK List 


SYSCM 


$FRKHD 


— 


FORK 
BLOCK 
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SYSTEM SYNCHRONIZATION 


CALL CALL 
eee a $DIRSV SINTSV 
PR7 
cru BRS 
$FORK 


PRO RETURN RETURN 
pues TO $DIRXT TO $DIRXT 
250. 
TASK { 
PRIORITY 
A. alo INTERRUPT 
ai (TRAP) AT BR4 
0. 
SYSTEM STACK | PS | | PS | 
SSTACK:: 
STACK DEPTH $STKDP:: 


INDICATOR 


Figure 8-11 Interrupting a Task 
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SYSTEM SYNCHRONIZATION 


CALL CALL 
—— $DIRSV SINTSV 
PR7 RETURN 
ah TO $INTX1 
PR6 


PRIORITY PR4 


RETURN 
TO $DIRXT 


INTERRUPT | 


TASK { AT BR6 

PRIORITY aio 

1 (TRAP) 

O. 

—. | PS | 

SDIRXT] [$DIRXT $DIRXT 

SYSTEM STACK setae | PS |{ PS |] PS _|[{ PS | 
STACK DEPTH — $STKDP:: ee 
INDICATOR 


Figure 8-12 Interrupt Executive Processing a Directive 


SYSTEM SYNCHRONIZATION 


CALL CALL CALL 
PR7 SINTSV SINTSV SINTSV 
aston RETURN 
PR6 TO $INTXI 
CPU PRS 
PRIORITY PR4 RETURN RETURN 
TO $INTXI TO $INTXI 


PRO INTERRUPT 
—— AT 
250. one 
TASK { 
PRIORITY 
1. INTERRUPT INTERRUPT 
--- AT AT 


O. BR4 BR4 


SYSTEM STACK 
$STACK:: 


STACK DEPTH = $STKOP:: [0] Co JCo JC-1)Co) 


INDICATOR 


Figure 8-13 Interrupt Executive Processing an Interrupt 
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SYSTEM SYNCHRONIZATION 


CALL 
ene SINTSV 


PR7 CALL 
ee. $FORK RETURN 
PR6 
CPU TO $DIRXT 
PRIORITY iy, TASK TASK 
| EXIT 
— (TRAP) 


PRO 
250. 
TASK { EXEC IDLE 
PRIORITY INTERRUPT 
1 AT BR4 
--- | R44 | 
O. _{ _ R5 | 
—— | PC | 
| PS _ |] PS | 
| RO |{ RO j|{ RO |/{ RO | | RO | 
| Ri |] Ri |] R1 |] R11 | | RI | 
| R2 | { R2 |[ R2 |] R2 | | R2 | 
| RS |{ RS |{[ RB |] R3_ | | RS 
| R4_|{ R4 |[ R4 |] R44 | | R4 
| RS |] R5 |] R5 {7 RS | | RS 
| PC |] PC {|| PC |] PC | | PC 
SYSTEM STACK garner | PS | ~L_PS _ |{L_PS j{_PS | | PS | 
STACK DEPTH $sTKOP:: ([_O__] (_0O_] Co) Co) 


INDICATOR 


Figure 8-14 Interrupt Executive in an Idle Loop 
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SYSTEM SYNCHRONIZATION 


PRIVILEGED TASKS 


Privilege bit is set in Second status word in TCB 
Task can use privileged directives 
Task can perform privileged I/O functions 
Task can perform logical block transfers to/from mounted 
volumes 
Task is built privileged by using the /PR switch when 


taskbuilding 


/PR:@ creates privileged task whose mapping is the same as 
that of a nonprivileged task 


/PRin creates privileged task which maps to the Executive 


4 if Executive is 16K words 
5 if Executive is 28K words 


n 
n 
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SYSTEM SYNCHRONIZATION 


Processing a Privileged Task 


Privileged task must switch to KERNEL mode to access system 
data base 


Switch to KERNEL mode is performed by CALL SSWSTK,LABEL 
instruction 


CALL macro translates this to EMT 376 
CALL macro is in SY:[{11,18]RSXMC.MAC 
LABEL is a location in the privileged task to return when 
leaving KERNEL mode 
In module DRDSP, a jump to location $SWSTK in module SYSXT is 
executed 
The routine SSWSTK 


Moves the contents of USER mode APRs 5 and 6 to KERNEL 
mode APRs 5 and 6 


Moves the address of LABEL to location SP+16 on the stack 
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SYSTEM SYNCHRONIZATION 


LOW CR DRSUB 
i! Bev 
DIRSV$ 


EMT TRAP 
VECTOR 


USER PROGRAM SYSXT 
a aap $DRDSP:: $DIRSV:: 


JMP S$DRDSP ® 


CALL (R5) 
$DIRXT:: 


RTI 
SSWSTK:: 
CALLR @(SP)+ 


RETURN 
LABEL: 


JMP $SWSTK 


EXIT$S 


Figure 8-15 Privileged Task Processing 


SYSTEM SYNCHRONIZATION 


CALL CALL 
— $DIRSV $DIRSV 
PR7 
CPU Bae 
PRIORITY 
PR4 RETURN RETURN 
— TO $DIRXT TO $DIRXT 


PRO 
250. 
TASK { 
PRIORITY SWITCH Qlo 
1. STACK (TRAP) 
--- (TRAP) 
O. 
$DIRXT SDIRXT 
| RO | | RO | 
| R11 | | R11 | 
| R2 | | R2 | 
| RS | | RS | 
| R4 | | R4 | 
| RS | | R5 | 
SYSTEM STACK gece | PS |] PS | | PS |[{ PS J 
STACK DEPTH  $STKDP:: Co) [oJ 


INDICATOR 


Figure 8-16 Privileged Task Switches Stack and Returns 
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SYSTEM SYNCHRONIZATION 


CALL TRAP FORK 
ROUTINE PROCESS 


SAVE R5-RO ON NO |REMOVE FORK 
$DIRSV THE STACK $DIRXT LIST ENTRY BR $DIRXT 
DEC $STKDP RESTORE 
R4. R5 
YES 
; INC $STKDP 
RESTORE 
RO-R3 RESTORE RTI 


R4, R5 


SELECT 
POWER NEW TASK 
FAIL? AND SWITCH 
CONTEXT 


YES 
NO IDLE 
LOOP 

YES 


BR $DIRXT BR $DIRXT 


Figure 8-17 System Synchronization Logic: S$DIRSV 
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SYSTEM SYNCHRONIZATION 


SOIRXT 


SAVE R3-RO ON 
KERNEL STACK 


SAVE PC, R5 FORK 
IN FORK BLOCK ace 
LINK BLOCK INTO LIST 


ON TE” STACK INC $STKDP 
oINTSY STACK SINTXT DEPTH - RESTORE 
=0? R4, R5 
DEC $STKDP 


CALL INTERRUPT 
SERVICE ROUTINE 


Figure 8-17 System Synchronization Logic: S$DIRXT, $FORK, 
: and SINTSV 
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WRITING PRIVILEGED TASKS 9 


WRITING PRIVILEGED TASKS 


INTRODUCTION 


In many practical environments, it is often necessary to 
write tasks which must interact with the Executive in ways not 
planned by the designers of the operating system. The tool used 
in these situations is the privileged task. (In this module, 
"privileged task" refers to a task which maps to the Executive.) A 
privileged task has access to both the system data base and 
Executive code and can therefore act as an extension of the 
operating system. 


To write and use privileged tasks, the programmer must 
understand the operating system, the system data base and the 
methods that the Executive uses to synchronize access to the 


System data base. The previous modules, together with this 
module, provides that understanding. 


OBJECTIVES 


1. Assemble and taskbuild privileged tasks. 
2. Use a privileged task to access the system data base. 


3. Use Executive routines to perform tasks. 


RESOURCES 


1. RSX-11M System Lists and Data Structures 
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WRITING PRIVILEGED TASKS 


OVERVIEW 


Why Write a Privileged Task 
e To acquire the privileged attribute 
Allows task to issue privileged directives 
Allows access to any file without protection checks 


Allows task to issue logical block I/O to a mounted volume 


e Tasks which map to the Executive have access to: 
Routines contained in the Executive 
Executive data base including 

System Common (SYSCM) 
System device tables (SYSTB) 


Dynamic Storage Region (POOL) 


The I/O Page 
Device registers 


Memory management registers 
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WRITING PRIVILEGED TASKS 


Privileged Task Structure 
e Consists of at least three sections 
First section 
Executes in USER mode 
Contains the transfer point of the task 
Contains code for processing before transferring to 
system state 
Second section 
Executes in KERNEL mode 


Contains code which accesses Executive data 


Third section 
Executes in USER mode 
Contains return location from KERNEL mode 


Contains code for processing data obtained from the 
Executive in the second section 


@e USER Mode APRs 
For system with 16K word Executive 
APRs @ - 3 are used to map the Executive 
APRs 4 - 6 are used to map the privileged task 


APR 7 is normally used to map the I/O page but can map 
an added 4K words of the task if needed 


Privileged task can be 
12K words if I/O page is needed in USER mode 


16K words if I/O page is not needed in USER mode 
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WRITING PRIVILEGED TASKS 


e For system with 20K word Executive 
APRs @ - 4 are used to map the Executive 
APRs 5 and 6 are used to map the privileged task 


APR 7 is normally used to map the I/O page but can map an 
added 4K words of the task if needed 


Privileged task can be 
8K words if I/O page is needed in USER mode 


12K words if I/O page is not needed in USER mode 
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WRITING PRIVILEGED TASKS 


Restrictions on Privileged Tasks 
e Parameter Passing 

User state to system state 
Values can be passed in registers R@ —- R5 
Values can be passed in memory locations 

System state to user state 
Values can only be passed in memory locations’ since 
registers are restored 

e Time spent in system state should be minimal 


Interrupt processing affected since the FORK queue is’ not 
serviced 


No other user task can execute 


e No trap can occur in system state 
No directives can be executed 


Traps in system state cause a system crash 


e Privileged instructions should be used with care 
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WRITING PRIVILEGED TASKS 


CREATING A PRIVILEGED TASK 


Assembling a Privileged Task 


e To assemble a privileged task to map to the Executive: 


>MAC File,File=[(1,1]EXEMC/ML,[11,18]RSXMC/PA:1,(USER UIC]File 


e EXEMC.MLB 
Contains 
Macros defining offsets 


Bit values for all system data structures 
Not needed if no reference is made to these structures 


e RSXMC.MAC 
Contains 
Conditional assembly symbols defining the system 


Several commonly used macros such as CALL and CALLR 


Always needed to interpret CALL $SWSTK 
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WRITING PRIVILEGED TASKS 


Taskbuilding a Privileged Task 


The following command is needed to taskbuild a privileged task 


which maps to the Executive 


>TKB File/PR:n=File,[1,1]EXELIB/LB,[1,54]RSX11M.STB 


EXELIB. 
Executive object library 


Contains global symbols for resolving 
structures not resolved during assembly 


RSX11M.STB 
Executive symbol table file 


Allows resolution of Executive global 
privileged task 
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offsets 


symbols 


in 


used 


data 


in 


WRITING PRIVILEGED TASKS. 


SAMPLE PRIVILEGED TASKS 


Tracing Through System Lists 


e Function of privileged task 


Calculate and display size of free pool 


e The pointer S$CRAVL is used to access the list of free 
blocks 


e SSWSTK is used to switch to system state 
e Time spent in system state is minimal 


System data accessed in system state 


e I/O performed in user 


No traps in system state 
e Size of free pool is saved before return to user state 


Registers cannot be used to pass data from system to 
state 
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pool 


user 


Pointer* 


$ LOGHD 
SCRAVL 
SACTHD 
SCFLPT 
S$FRKHD 
SCLKHD 
$PARHD 
STSKHD 
SGGEF 

SERHEA 
S$ PKAVL 
SUMRHD 
SUMRWT 


SMOULS 


WRITING PRIVILEGED TASKS 


Table 9-1 Pointers to System Lists 


System List 

Logical device assignment list 

Free pool block listhead 

Active task list listhead 

Pointer to first checkpoint file PCB 
FORK queue listhead 

Clock queue listhead 

Pointer to partition list 

Pointer to system task directory 

Pointer to group global event flags list 
Error logging message queue listhead 
Pointer to list of preallocated I/O packets 
Mapping assignment block listhead 

UMR wait queue listhead 


Mounted device listhead 


*All pointers are located in SYSCM 
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WRITING PRIVILEGED TASKS 


Table 9-2 Pointers to Data Structures 


Pointer* | Description 

SHEADR Pointer to current task header 
STKNPT Pointer to TKTN TCB 

SSHFPT Pointer to shuffler TCB 

SMCRPT Pointer to MCR TCB 

STKTCB | Pointer to current task TCB 
SLDRPT Pointer to loader TCB 


*Al1l pointers are located in SYSCM 
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9E?¢ 


FPOOLA 


SOOnNACHES Gh 


MACRO M1200 


000000 
000030 
000032 


000053 


000120 
000120 
000122 
000126 
000132 
000136 
000140 
000142 
000144 
000150 


000152 
000156 
000162 


2 000166 


Q00172 
000176 
000204 


124 
000045 


005001 
012700 


0466001 
011000 


001374 
006201 
010167 


000207 


012700 
012701 
012702 


010167 


000120’ 


Example 9-1 


000000G 


000002 


177660 


000053’ 
000032’ 
000030’ 


177620 


29-TEC-81 132354 PAGE 3 


e+ 


“> “So Gp “S> SP “E> 


OUTQATIO?: 
ARGLST$ 


24 OUTMES: 


RUFFL 
OUTRUF ¢ 


START 


1083 


Cad a> en ee 


Tracing 


(Sheet 1 of 2) 


TITLE 


FOOLA 


*x - POOLA - DISPLAY POOL SIZE 


THIS TASK WILL CALCULATE AND DISFLAY THE TOTAL SYSTEM 
DYNAMIC STORAGE REGION SIZE 


eMCALL 
«NLIST 
QIOwWws 
+BLKW 
+ASCIZ 


+BLKB 
+EVEN 


CLR 
MOV 
CALL 
ADI: 
MOV 
BNE 
ASR 
MOV 
RETURN 


QIOW$sEXITSESe DIRS 

REX 

IO.WVBylyler ye OUTBUF 2 Or 40> 

1 » ARG LIST FOR $SEIDMSG 
7TOTAL FOOL = ZI./ 

+ -OUTMES+20. 


BUFFL 
Ri ’ FOR TOTAL FREE SPACE 
#$CRAVL »*RO ¢ POINT TO FIRST DSR FACKET 
S$SWSTK sr 308 ¢ SWITCH TO SYSTEM STATE 
2°(RO) eR1 ¥¢ ALL IN SIZE OF THIS FACKET 
CRO) rRO 9% GET LINK TO NEXT PACKET 
10% #9 IF NE NOT END OF LIST 
Ri 95 CONVERT TO WORDS 
Riv ARGLST 9% SAVE SIZE OF DSR 

a 


RETURN TO USER STATE 


FORMAT AND PRINT OUTPUT 


MOV 
MOV 
MOV 
CALL 
MOV 
DIRS 
EXIT$S 
-END 


SET OUTPUT STRING 
AND INPUT STRING 
FARGLST rR2 AND ARGUMENT LIST 
$EDMSG FOR EDIT MESSAGE 


¥OUTBUF »RO ; 
, 
Ri OUT@IO+A, IOPL+2 ’ UPDATE MESSAGE SIZE 


FOUTMES sR1 


#0UTQIO WRITE OUT MESSAGE 
ANT EXIT FROM FROGRAM 
START 


Through System Lists 


SHSWL GHOST TIAIYd ONILIYM 


LE? 


FOOLA 


MACRO M1200 


SYMBOL TABLE 


ARGLST 
AS$CHK= 
AS$CLI= 
A$$CNT= 
AS$CPS= 
A$S$NST= 
AS$SPRI= 
ASSTRP= 
BUFFL = 
C$$CNA= 
C$$CKP 
CBSINT= 
CS$0RE= 
C$$RSH= 
C$$RUN= 
O$$Hit= 
Li$$TAG= 
U$$ISK= 
US$Lii= 
NS$M11 
LS$PAR= 
i$$SHF= 
L$ $UCK= 
L$$YNC= 
L$ $YNM= 
$$ZMDe= 
U$$Z11= 
ES$nVUC# 
ES$NSI= 
E$$PER= 
ES$XPR= 
FS$LPP= 
F$$LUL= 
G$$TPP= 
G$$TSS= 


« ABS. 


ERRORS 


000030 
000000 
000020 
000000 
000000 
000000 
000000 
000000 
000045 
000002 
000000 
YQOQ000 
001000 
177564 
000000 
000003 
000000 
000000 
000001 
000003 
000000 
000000 
000000 
000000 
000000 
000000 
000001 
000000 
000000 
000000 
000000 
000000 
000001 
000000 
000000 


000000 
000212 


NETECTEDS 


2O-NEC@ BL 13354 


000 
001 


VIRTUAL MEMORY USET3 


DYNAMIC 
ELAPSED 


MEMORY ? 
TIME: 


G$$TTK= 
HOSRTZ 
I0.WVE= 
L$$CSZ= 
I$$RAR= 
I$$RDN= 
KS$ONT= 
K$$CSR= 
K$$lAS= 
K$$LEN= 
K$$L0C= 
K$$TPS= 
LO$Cg = 
LISI = 
LISDE = 
LISI = 
LISI, = 
LISI = 
LOSDR = 
LOSS = 
LISD = 
LUSnY = 
LOSLF = 
LISMM = 
LINSNL = 
LOSRE = 
LUSTT = 
LOSVT = 
LK. SPN= 
LK WAT= 
L$$ASG= 
L¢$DBG= 
LésDRV= 
Lo$l c= 
Lé$FTO= 


11375 WORTIS 
12692 WORDS 
00200312 


000000 
000074 
KKK KKK 
000200 
000000 
000000 
177546 
177546 
000000 
000115 
000001 
000074 
900000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 


7 000000 


000000 


= 900000 


000000 
000000 
000000 
000002 
000010 
000000 
000000 
000000 
000000 
000170 


FAGE 


GX 


( 45 PAGES) 
( 48 PAGES) 


L$$Pits= 
L$$1ik= 
M$$CRB= 
M$$CRX= 
M$$EXT= 
M$$FCS= 
M$$MGE= 
M$$MUF= 
M$$NET= 
M$$OUR= 
M$$XLN= 
NS$L VE: 
NS$MOV= 
NS$SUMR= 
QUTEUF 
QUTMES 
QUTaIO 
PS $I70= 
P$$GMX= 
PS$LAS= 
PS$MAX= 
PS$OFF= 
PS$00L= 
PS$P45= 
PS$REL= 
PS$RTY= 
PS$SRE = 
PS$WND= 
QS$OPT= 
Q. LOAE= 
Q. 1OEF= 
Q. IOFN= 
Q.TOLU= 
Q.IOFL= 
Q. LOFR= 


000002 
000000 
000124 
000000 
900000 
000000 
000000 
000000 
002627 
000000 
000400 
000001 
000041 
000030 
000053K 
000032K 
OOOOOOR 
000000 
000000 
000000 
000400 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000005 
000012 
000006 
000002 
000004 
000014 
000007 


YPOOLA=LEBIL2sG4IRSXMC/PAS Ley Cis LIEXEMC/ML sDR22 0305» 3067 F00LA 
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Q, 10SE= 
$$ CON= 
RS$SDER= 
R$$lGP= 
RS$EIS= 
RS$SEXV= 
RS$HIIV= 
RS$H11= 
RS$IPL= 
R$$JG1= 
RS$Kii= 
RS$LKL= 
RS$Lii= 
RS $MPL= 
RS$SM11= 
RS$NDC= 
R$ $NDH= 
RS$NDL = 
R$$SND= 
RS$X21= 
R$$11M= 
R$$611= 
START 

S$$ECC= 
S$$HDW= 
S$$LIB= 
S$$NM1= 
S$$NM2= 
S$$NM3= 
S$$0FT= 
S$$UBD= 
S$$WFC# 
S$$WPR= 
S$$WRG= 
S$$YSZ= 


000010 
000000 
000000 
000000 
000000 
000000 
000000 
000004 
000004 
000004 
000001 
000001 
000001 
000000 
000004 
000006 
000226 
000001 
000000 
000001 
000000 
000001 
000120R 
000000 
000000 
000000 
042513 
046522 
052111 
000000 
000000 
000036 
000005 
000000 
044000 
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TSSBTW= 
TS$CCA= 
TS$COM= 
TS$$CON= 
TS$CTR= 
TS$$CUP= 
TS$C11= 
TS$ESC= 
TS$$GMC= 
TS$GTS= 
T#$KMG= 
TS$LWC= 
T$$MO3= 
TS$$RED= 
T$$RNE= 
TS$RPR= 
TS$RST= 
TS$$RUB« 
T$$SMC= 
TS$UTO= 
T$$US8= 
US$DAS= 
US$MHI= 
US$MLO= 
US$MRN= 
V$$CTR= 
V$$TL= 
V$$TLM= 
V$$TRM= 
X$$DBT= 
X$$HDR= 
$CRAVL= 
$ETIMSG= 
$$$ARG= 
$$$0ST= 


000000 
000000 
000000 
000000 
000000 
000000 
000001 
000000 
000000 
000000 
000000 
000000 
000002 
000000 
000000 
000000 
000000 
000000 
000000 
000036 
000001 
000000 
000000 
140000 
170230 
000774 
000120 
000205 
000000 
000000 
000000 
KKKKKK 
KKK KKK 
000003 


000014 


GX 
GX 
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WRITING PRIVILEGED TASKS 


Calling Executive Routines 


e Function of privileged task 


To simulate issuing an MCR command from a terminal 


e Privileged task must construct MCR command block 
Terminal UCB is located by searching device list 


MCR command block (84 bytes) is allocated from pool by 
uSing routine $ALOCB 


Block is queued to MCR by using routine SQMCRL 


Block is deallocated on I/O error by calling $DEACB 


e Time spent in system state is minimized by returning to user 
state to perform calculations, etc. 


Table 9-3 Executive Pool Routines* 


Entry 
Point Description ie Inputs Outputs 
$ALOCB Allocates a variable Rl = Size of | C-bit = @ Block allocated 
length core buffer buffer C-bit = 1 Insufficient space 
. : R@ - Address of block 
‘First fit . Rl - Length of block 
Length in multiples 
of four bytes 
SDEACB Deallocates a variable R@ = Address None 
length core buffer of block 
Rl = Block 
size 


*All routines are in Executive module CORAL 
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Entry 
Point 


SQINSF 


SQINSP 


SQINSB 


SQRMVF 


SQRMVT 


SQMCRL 


*Al1 routines are in Executive model 


WRITING PRIVILEGED TASKS 


Table 9-4 


Description 


Inserts entry at end 
of FIFO queue 


Saves R@, Rl 


Inserts entry in a 
priority ordered 
queue 
Saves R@, Rl 


Inserts entry at 
beginning of queue 


All registers are 
saved 


Removes entry from 
beginning of queue 


Saves R@ 
Removes entry with 


a specifed TCB address 


Queues a command line 
to CLI of issuing terminal 


Inputs 


R@ = Address of 
listhead 

Address of 
new entry 


Rl = 


(Same as SQINSF) 


(Same as SQINSF) 


R@ = Address of 
listhead 

R@ = Address of 
listhead 

Rl = TCB address 

Rl = Address of 


command line 


QUEUE 
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Executive Queueing Routines* 


Outputs 


None 


None 


C-bit = @ Entry 
C-bit 1 Empty 
Rl - Address of 


tl 


C-bit = 9 Entry 
C-bit = 1 Entry 
Rl - Address of 


None 


removed 
list 
entry 


removed 
not found 
entry 


WRITING PRIVILEGED TASKS 


Table 9-5 Other Executive Routines 


Entry _ 
Point Description Inputs Outputs 
S$SRSTD Searches STD for R3 = Address of C-bit = @ Task found 
specified task RAD58 task C-bit = 1 Task not found 
name R@ = TCB address of task 


Module: REQSB 


$SRNAM Search the partition R3 = Address of C-bit = @ Partition found 
list for a named - RADS® name C-bit = 1 Not found 
partition R2 = PCB address 


Module: PLSUB 


$CEFI Converts an event R@ = Event flag R@ = Mask word 
flag number to an number Rl = Event flag address 
event flag address R5 = TCB address 
of task 


Module: EXESB 


246 


TR? 


TERM 


MACKO M1200 2 


23 000000 


27 000000 
000003 
0000046 
Oooo011 
000014 
000017 
000022 
000025 
000030) 

28 

29 000033 
000036 
000041 
000044 
000047 
000082 
000055 
000060 

30 

31 000062 
000065 
000070 
000073 
000074 
Q00101 
000104 
000107 
OO0O112 
OOo01 1S 
000120 

Se 


O12 
116 
122 
040 
122 
116 
040 
115 
122 
000033 
105 
105 
101 
117 
101 
040 
122 
103 
000027 
114 
1O2 
040 
040 
124 
103 
114 
124 
0490 
101 
O41 
000037 


2°" O0CT-84. 


OL 
124 
940 
124 
115 
101 
114 
102 
9072 


114 
122 
040 
11S 
114 
1064 
040 


122 
125 
105 
114 


116 
040 
124 
054 
122 


Lol 
Lia 


12340 


105 
105 
101 
105 
til 
114 
125 
105 
040 


124 
040 
103 
115 
104 
117 
115 


115 
122 
123 
117 
11? 
101 
040 
131 
107 


114 


Example 9-2 


FAGE 3 


“> “c> > “> "> “> “> SP SP “EP ‘E> “CDP? “KP E> “EP “EP “KP “> “SP “ED 
+ 


> 


“Ti a> o> «> 


FLEN 
MES13 


LENT 


MESS13 


LEN 


*+TITLE TERM 


THIS TASK ASKS THE USER FOR A TERMINAL NUMBER ANI A 
COMMAND LINE. IT THEN FASSES THE COMMANT TO MCR 

AS IF HAD ORIGINATED AT THE SPECIFIED TERMINAL. IT 
FERFORMS THIS TASK BY USING SYSTEM SUBROUTINES» $ALOCK 

AND ¢QMCRL» TO ALLOCATE A BLOCK FROM FOOL AND FASS IT 

TO MOR. 

THE TASK MUST BE BUILT FRIVILEGED AND MAF TO THE EXECUTIVE. 
TO ASSEMBLE? 

>MAC TERM=C191I7EXEMC/MLyC11»1OIRSXMC/FAI 1+ OC CYOUR UIC) ITERM 
TO BUILT: 

STKE TERM/PR?S=TERMs C1 sS4IRSX1L1IM.STE/SS 

*MCALL EXIT$S»QIOWSSsDCKIFS 

TCRIOF $ 

TERMINAL MESSAGES 


*ASCIT @122<15>/ENTER A TERMINAL NUMBER? / sPROMPT 


= eo PRMT *LENGTH OF FROMFT 
“ASCII /ENTER A COMMANT FOR MCR/ 


if 


Hy + ~MESL 
eASCILT /NUMBER IS NOT OCTALs TRY AGAIN! / 


+~MESSIL 
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CUC 


TERM 


33 


34 
35 


36 
37 


MACRO M1200 


000121 
000124 
000127 
000132 
000135 
000140 
000143 


000144 
000147 
0001S2 
000155 
000160 
000163 


000166 
000171 
000174 
000177 
000202 
000205 
000210 
000213 
000216 


000220 
000224 
000230 
000232 
000234 
000236 
000240 
000242 
000244 
000246 


000250 
000322 
000374 
000400 
000404 
000406 


000412 


3 OO0414 


000416 
000422 
000426 
000432 
000434 


124 
115 
101 
116 
040 
125 
041 
000023 
1146 
120 
114 
126 
114 
114 
000022 
111 
040 
122 
040 
040 
115 
116 
111 
125 


000032 


124 
197777 
000000 
000000 
000000 
000000 
000000 
000000 


016703 
012700 
005002 


005702 
001402 
000147 


012700 
011000 
001422 


105 
lil 
114 
117 
104 
116 


117 
117 
040 
101 
101 
105 


0357 
105 
117 
117 
103 
115 
104 
116 
124 


177626 
000220" 


000436 


0000006 
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122 
116 
040 
124 
117 
104 


040 
117 
101 
111 
102 
041 


117 
122 
122 
116 
117 
101 
040 
120 


FAGE 3-1 


ERMES: .ASCII /TERMINAL NOT FOUND !/ 


sMAKE SURE OF WORT) BOUNDARY 


#RUFFER FOR TERMINAL NUMBER 

71/0 STATUS BLOCK 

¥TERMINAL NAME 

sERROR INDICATOR 

7ADITIRESS OF COMMAND LINE IN FOOL 
sADDRESS OF FOOL BLOCK 

sSAVED UCR ALTIRESS 

sSAVET! NCR ADDRESS 

sSAVET! LOW UNIT NUMBER 


ERL = o7ERMES 
FOOL > “ASCII /NO FOOL AVAILABLE! / 
PL = +-FOOL 
IGERR? .ASCII !1I1/0 ERROR ON COMMAND INFUT! 
IOL = +-~IOERR 
+EVEN 

5 
, FROGRAM TATA 
; 
BUF? +BLKE 4 
IOSE? + BLKW 2 
NAMS *ASCII /TT/ 
ERRCNT?: .WORD “1 
COMM: «WORT 0 
PLACE? WORD 0 
UCE; «WORT! 1?) 
DICK: +WORT i?) 
LOW: *WORT 0 

0 


HIGH: «WORT 


REGINNING OF CODE 


ISAVET HIGH UNIT NUMEER 


ERM? QIOWSS #FIOWVR #59 F127 7 SSP RMT» BPLENy €40> yPROMFT 


QIOWSS #1IO.RVEe #52417 7410SRy ye ceRUF yy $42 FGET °TT’ NUMBER 


MOV TOSE+2 2 h3 
MOV BUF 9 KO 
CLR R2 
CALL $COTEH 
TST R2 
REQ CONT 
JMF ERR1I 
CONT: CALL SSWSTKy RACK 
MOV FS$NEVHIty RO 
Li: MOV (RO) RO 
REQ GO 
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¥SAVE CHARACTER COUNT 

¥SET UF FOR CALL TO CONVERSION 
§ ROUTINE - FROM ASCII TO 

¢ BINARYCOCTAL > 

¢ Ri WILL CONTAIN CONVERTED NUMBER 
¢ R2 WILL CONTAIN TERMINATOR 
#TEST FOR ERROR 

yIF NOT CONTINUE 

*GO TO ERROR ROUTINE 

*9SWITCH TO SYSTEM STATE 

ssFICK UF LISTHEAL FOR DCE LIST 
#3GO TO NEXT DCE 

¢3IF NONE FINISH UF 


Calling Executive Routines 
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eve 


TERM 


MACRO M1200 


227-0CT 8. 


. 000436 026760 177564 


000444 001372 

000446 1146067 000006 
000454 116067 000007 
000462 020167 177560 
000466 003361 

000470 010067 177546 
000474 062767 900001 


000502 
000504 


000504 005767 177522 
000510 001402 

OOOG12 000167 000430 
000516 016700 177520 
000822 0146002 000002 
00052 010104 

000530 166704 177510 


000534 016005 000010 
000540 070504 
000542 0460502 
000544 010267 177470 
000550 012767 177777 


000556 


000562 012701 000124 


0005466 


Q00572 103404 
000574 005267 177432 
000600 010067 177432 


000604 
000606 


000606 005767 177420 
000612 001402 

000614 000167 000406 
000620 012700 000124 
000624 016701 177406 
000630 112721 000040 
000634 077003 

000636 016767 177374 
000644 0462767 000004 


000652 


000724 005067 177274 
000730 005067 177272 


QO0734 


001006 103002 
001010 000167 0002872 
001014 105767 177204 
QOO0TO20 002002 
OOLO2R2 000167 000260 


001026 


OO10352 016701 


177200 


001036 O16761 177176 


001044 
001050 
QOLOS2 
QOOLOS2 


12340 PAGE 3-2 


000004 
177570 
177564 
177530 
GOs 
BACK: 
1$3 
177454 
NONE? 
BACK23 
12 
2S) 
177370 
177362 
3H 
4$3 
000002 
BACKS % 


4 
Y 


Example 9-2 


CMF NAM + Il. NAMCRO) 
BNE La 
MOVE L. UNIT CRO) » LOW 
MOVE T.UNIT+4 (RO) HIGH 
CME Riv HIGH 
BGT Ld 
MOV RO» TICK 
Alt #1 ,ERRONT 
RETURN 
TST ERRCNT 
REQ 1$ 
JME ERR2 
MOV ICE» RO 
MOV D.UCE(RO) +R2 
MOV Rivk4 
SUR LOWs R4 
MOV LUCEL (RO) 9 RS 
MUL. R4ekS 
Al RS R2 
MOY R2eUCH 
MOV #1 ERRONT 
CALL. $SWSTKy BACK? 
MOV #84. 9R1 
CALL $ALOCE 
BCS NONE. 

INC ERRCNT 
MOV RO rFLACE 
RETURN 
TST ERRCNT 
REQ 16 
JMF ERR 
MOV #84. 9RO 
MOV PLACE RA 
MOVE #40» (RA) + 
SOR RO» 2% 
MOV PLACE »COMM 
ann #4*°COMM 
QTOWSS 
CLR LOSK 
CLR LOSH+2 
ATOWSS 
BCC 3 
JMF ERR4 
TSTB rose 
RGE As 
JME ERR4 
CALL $SWSTK » RACKS 
MOV PLACE Ri 
MOV UCEy 2(R1) 
CALL $QMCRL. 
RETURN 
EXIT#S 

Calling Executive 


$#IOWVR yo tS etl yee ep EMESL » #LENTI 7 F40> 


#IO.RVBy #59 #19 TOSRy r= COMM, #80, > 
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gLOOK FOR “TT? DCE 

sIF NOT “TT’ GET NEXT DCB 
s;GET LOW UNIT NUMBER 

§GET HIGH UNIT NUMBER 
SCOMPARE INFUT WITH HIGH 
gIF INFUT LARGER GET NEXT DICE 
ISAVE ICR ADNRESS 

sINDICATE NO ERROR HERE 
sRETURN TO USER STATE 

sNOW IN USER STATE 

sTEST FOR ERROR 

sCONTINUE IF OK 

9G0 TO ERROR ROUTINE 

IGET DCH ALDRESS 

9GET ANDRESS OF FIRST UCE 
yMOVE FOR CALCULATIONS 

sFING THE NUMBER WITHIN UCES 
§ FOR CURRENT DICE 

sGET UCR LENGTH 

sCALCULATE OFFSET FOR UCE 
sCALCULATE BEGINNING OF UCR 
ISAVE UCR ALIIRESS 

sRESET ERROR COUNT 

ySSWITCH TO SYSTEM STATE 
$9SET BLOCK SIZE 

SFALLOCATE BLOCK FROM FOOL 
99NO ROOM IN FOOL 

s$INIICATE NO ERROR HERE 
§7SAVE ADIIRESS OF FOOL BLOCK 
s#RETURN TO USER STATE 

¢RACK IN USER STATE 

sCHECK FOR ERROR 

sCONTINUE IF OK 

#GO TO ERROR ROUTINE 

sSET LENGTH OF BLOCK 

#GET ALTIRESS OF BLOCK 

gFLACE BLANKS IN BLOCK 

¢LOOF UNTIL THROUGH 
sCALCULATE LOCATION OF COMMANI: 
¢ LOCATION IN BLOCK 

gFROMPT FOR COMMANT! 


a 
¥ 
a 
F 
a 
y 
a 
y 
a 
g 
a 
¥ 
a 
g 
“ 
¥ 
a 
y 
a 


sINFUT COMMANIT 
SCONTINUE IF ON 

sRRANCH IF QIO ERROR 

ICHECK FOR I70 ERROR 
§CONTINUE IF OK 

*RRANCH IF ERROR 

$s9SWITCH TO SYSTEM STATE 
99GET ADRESS OF BLOCK 
SePLACE UCR ANDRESS IN BLOCK 
sS;QUEUE BLOCK TO MCR 

SSLEAVE SYSTEM STATE 

#RACK IN USER STATE 

yEXIT 


Routines 
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DPC 


TERM MACRO M1200) 22-0CT-81 122340 FAGE 3-3 


128 3 ROUTINE TO HANIILE BAD TERMINAL NUMBER 

129 , 

130 0601060 ERR1 3 QIOWSS F1I0.WVERr t5rF1l e992 #MESS1 yy SFLEN1I » $402 sPRINT MESSAGE 
131 001132 012700 000220° MOV #BUF »RO sGET INFUT BUFFER ADDRESS 

132 001136 005020 CLEARS CLR (RO) + yCLEAR BUFFER 

133 001140 077302 SOB R3»CLEAR #R3 CONTAINS CHARACTER COUNT 
134 001142 000167 177102 JMF TERM yTRY AGAIN 

135 , 

136 3 ROUTINE TO HANDLE NON-EXISTENT TERMINAL 

137 , : 

138 001146 ERR2? QIOWSS FIO.WVERs #5781999 9 <8ERMES» SERL » $40> sPRINT MESSAGE 
139 001220 EXIT$S sEXIT 

140 5 

141 , ROUTINE TO HANDLE FOOL ALLOCATION FAILURE 

142 5 

143 001226 ERR3$ QIOWSS FIOWVRe F579 F179 9 oP OOL y FPL #40> SPRINT MESSAGE 
144 001300 EXIT$S sEXIT 

145 5 

146 ? ROUTINE TO HANDLE I/70 ERRORS ON COMMAND INFUT 

147 , THE FOOL BLOCK MUST KE D'EALLOCATED! 

148 , 

149 001306 ERR4$ QIOWSS #1IO-WVRr tie tle ry ei tIOERRe #101 » €40> sFRINT MESSAGE 
150 001360 CALL SSWSTKeFIN , ¥#9SWITCH TO SYSTEM STATE 

151 001364 016700 176646 MOV FLACE »RO y5GET ALIRESS OF BLOCK 

152 001370 012701 000124 MOV #84. 9R1 ¥¢SET BLOCK LENGTH 

153 001374 ~ CALL $DEACK yeDEALLOCATE BLOCK 

154 001400 RETURN y*LEAVE SYSTEM STATE 

155 001402 FIN? *BACK IN USER STATE 

156 001402 EXIT$S sEXIT 

157 000250" +ENT TERM 
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SvC 


TERM MACRO M1200 22-0CT-81 12340 PAGE 3-4 
SYMBOL TABLE 


AKFBLO= 000000 t.MSK 000014 K$$TEN= 


A$$BRT= 000000 th. NAM 000004 K$$L0c= 
AFSCHK= 000000 l.FCR 000034 KR$$TFS= 
ASSCL T= 000004 D.UCK 000002 LUsCQ = 
AKSCFS= 000000 U.UCKL 000010 LOS = 
AS$NST= 000000 NUNIT 000006 LOK = 
ASSFRI= 000000 tie VCAN= 000002 LOStl = 
ASSTRE= 000000 U.VOER= 177774 LOSGM = 
RACK OOOGO4K NeVINT= 000000 LOS = 
RACK? O00606R 0. VOUT= 000004 LUSIS = 
BACKS OOLOS2R D.VEWF= 000006 LUSOT = 
BUF OOO0220R ERL = 000023 LOGLP = 
RS$_Vl= 030463 ERMES OO0L2IR LOGMM = 
RS$LV2Q= 020040 ERRCNT 000232K LOSTT = 
CLEAR QO1LLI6R ERR1I OO1060R LENTIL = 
COMM 000234R ERR2 001145R LENL = 
CONT 000422R ERR3 001226R LOW 
CS$CNA= O0O0002 ERR4 001306R Lé$ASG= 
CH$CHE= 000000 ES$ACT= 000000 LéénRV= 
CHECKE= 000004 E¢$OVC= 000000 L$. [R= 
CE$CSR= 177404 ES$LOG= 000000 L$sPTO= 
CSSINT= 000000 EG$XPR= 000000 LS$Pii= 
CS$0NS= QOOQ00OL FIN 001402R Li 
CS$ORE® 002022 FS$LFPP= 000000 MESS1 
C$$NTM= 000000 FE$LV¥L= 000001 MES1 
CE$RSH= 177564 GO 000502K NS$CRE= 
CS$$RUN= 000000 GS$EFN= 000000 M$$CRX= 
CSESMT= 000000 GS$TFF= 000000 M#S$ETS= 
C$$TTY= 177564 GE$ETSS= 000000 MSSEXT= 
ice Q00242R GS$TTK= 000000 M$$FCS= 
USsHii= OOOOOL HIGH O00246R MSS$MGE= 
Lis $TAG= 000000 H#$RTZ= 000074 M#$$MUP= 
NS$TSK= Q00000 ITOERR 000146R M#$SOVR= 
Ué$¢lhi1= QOOO0R TOL. = 000032 NAM 
NS$M1i= 000001 IOSK 000224Kf NONE 
NSSF AR= 000000 TO.RVE= XKKKKK GX N$$lL ive 
LIS$SHF= O00000 TO.WVB= XKKKKK GX N¢$MOV= 
NS$WCOK= 000000 I$$RAR= 000000 N&$UMR= 
NS$YNC= 000000 I$$RON= 000000 FL. cal 
NS$YNM= 000000 K$$AST= 000000 PLACE 
QNSF 000012 K$$CNT= 172542 FLEN = 
1. LN 000000 K$$CSR= 172540 FOOL 
+ ARS. 000036 000 

001410 001 


ERRORS UETECTEDS 0 


VIRTUAL MEMORY USED? 10113 WORDS ¢ 40 FAGES) 

QYNAMIC MEMORY? 16120 WORDS ¢ 62 FAGES) 

ELAPSED TIME? 00200314 

TERM, TERM/-SPHl 1» LIEXEMC/ML yD11,1OIRSXMC/PAS Le C7» ITERM 
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000113 
000144 
000144 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000027 
000037 
000244R 
000000 
000000 
000000 
000036 
000001 
000432R 
000062R 
000033R 
000124 
000000 
000000 
600000 
000000 
000000 
000000 
000000 
000230R 
000604K 
000001 
000041 
000034 
000022 
000236R 
000033 
000144R 


FRMT 
PS $hPR= 
PS$CTL= 
PSSFRS= 
F$$GMX= 
PS$HIL= 
PS$LAS= 
F$$LOL= 
P$$O0FF= 
PSSPag= 
FS$RFL= 
PS$RTY= 
F$$SRF= 
Q$$0FT= 
RS$DER= 
RS$EXV= 
R$$JS1= 
RS$K11= 
RS$LKL= 
R$$L1i= 
R$$MOF= 
RS$M11= 
R$$NDC= 
R$$NDH= 
RS$NDL = 
RS$FOI= 


- RS$SND= 


RSS1liM= 
R$$60F= 
R$$611= 
S$$ECC= 
S$$NM1= 
S$$NM2= 
S$$NM3= 
S$$TIM= 
S$$TOF= 
S$$WLK= 
SS$$WPC= 
S$$WFR= 
S$$YSZ= 
TERM 

TSS$ACK= 


QOQOOOR 
000063 
000000 
000310 
000000 
003100 
000000 
001130 
000000 
000000 
000000 
000000 
000000 
000005 
000000 
000000 
000001 
000001 
000001 
000001 
000000 
000001 
000005 
000226 
000001 
000000 
000000 
000000 
000000 
000001 
000000 
OS1S22 
030530 
046461 
000000 
000000 
000000 
000036 
000005 
022000 
000250R 
000000 


Executive Routines 


TSé$BTW= 
T$$RUF = 
T$$CCA= 
T$$CCO= 
TS$$CPW= 
TS$CTR= 
TS$CUF= 
TS$$Cii= 
TS$$ESC= 
TS$GMC= 
T$$GTS= 
TS$HFF= 
TS$HLD= 
T$$J16= 
TS$$KMG= 
TS$$LWC= 
TS$$RED= 
T$$RNE= 
TS$RPR= 
T$$RST= 
T$$RUB= 
T$$SMC= 
TS$$SYN= 
TS$TRW= 
TS$UTB= 
T$$UTO= 
T$$US8= 
TS$$VBF= 
T$$30F= 
UCK 

US$MHI= 
US$MLO= 
US$MRN= 
V$$CTR= 
VS$RSN= 
X$$DET= 
$ALOCE= 
$COTE = 
$lEACK= 
$DEVHD= 
$QMCRL= 
$$$ARG= 


000000 
000000 
000000 
000000 
000000 
000000 
000000 
000001 
000000 
000000 
000000 
000000 
000000 
000001 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000170 
000001 
000000 
000000 
000240R 
000000 
160000 
170234 
000400 
000040 
000000 
KKKKKK 
KKK KK 
HOOK KKK 
FOO OK 
1K KK 
000002 


GX 
GX 
GX 
(3X 
GX 
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SYSTEM CRASHES 


SYSTEM CRASHES 


INTRODUCTION 


Only certain carefully defined SSTs are allowed in system 
state. System crashes occur when a Software fault is recognized 
within system state. The processor trap mechanism signals’ the 
system crash. CDA is a SYSGEN option which aids the system 
programmer in tracing system faults. When a fault occurs, the 
Executive trap handling facility saves the register context in 
memory, then passes control to the crash routine, which dumps’7 the 
memory to a disk or tape. The CDA utility may be used to format 
the dump information into a convenient report. 


OBJECTIVES 


1. To analyze a report generated by CDA to determine the cause of 
a system crash. | 


RESOURCES 


1. RSX-11M/M-PLUS Crash Dump Analyzer 


2. RSX-11M System Lists and Data Structures 
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CRASH PROCESSING 


Causes of Crashes 
e Processor traps in system state 
Powerfail and parity error traps do not cause crash 


Other processor traps cause system crash 


System automatically crashes 


e Processor HALTs or enters infinite loop 


System must be manually crashed 


e Manually crashing the system 
Physical location 48 contains the instruction JMP SCRASH 
Processor halted 
Address 49 loaded 


Processor restarted 


Crash Sequences 
e Three different crash sequences 

Initiated by IOT 

Initiated by EMT or TRAP 

Initiated by other trap 
Odd address 
Illegal instruction 
Memory management fault 


Floating-point fault/PIRQ 
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Crash Sequences 
e I0T 
Used when system detects an inconsistent system state 
Sequence: 
IOT trap vectors to the module SSTSR 
R@ - R5 are not saved 
Only PS and PC are pushed onto the stack 


Jump to $CRASH in module CRASH is executed 


Executive issues IOT only in modules DRDSP and SSTSR 


@ EMT or TRAP 
Results from EMT or TRAP attemp in system state 
Sequence: 
Directive save operation is performed 
Executive issues IOT 


Continue as with the IOT 


e Other Traps 
Traps vector to module SSTSR 
Directive save operation is performed 


If Memory Management Fault, the status registers SR@, SRl, 
and SR2 are pushed onto the stack 


One word fault code is pushed onto the stack 


Byte count of the information saved is pushed onto the 
stack 


Executive jumps to $CRASH 
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Obtaining a Crash Dump Analysis 


If XDT is present, respond with X to continue with crash 


Registers are printed on the console _ printer; the system 
halts 


Mount crash dump volume and press the continue switch 
After memory contents is saved, boot the system 
Run CDA to produce the analysis 


Inputs: The copy of memory created at the crash or by a 
previous execution of CDA 


The symbol definition file for the system 
Outputs: A listing file containing the analysis of the dump 


A binary file which is a copy of the contents of 
the crash dump volume 


Command Format: 
>CDA <CR> 
CDA>[{listfile/sw] ,(binaryfile/sw]=symbolfile/STB, 
crash-input[/sw] 

Two types of switches can be used 


Analysis switches - determine which CDA routines are 
applied to the input 


Function switches - provide control options 
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CRASH DUMP ANALYSIS 


Finding the Cause of a System Crash 

e Usually requires 
Output from the CDA utility 
Map of the operating system 


Listings and maps of relevant tasks 


e Common steps in interpreting a crash dump 
Get KERNEL stack pointer 


Examine KERNEL stack and $STKDP for sequence of 
(i.e., traps and interrupts) 


events 


Find PC and PS when trap occurred (from KERNEL stack) 


Determine APRs in use and find which APR mapped the 


instruction at which the crash occurred 


Use the Memory Map to locate the proper partition or 


region 


Use the listing and map of the code occupying the 
to locate the instruction 


e System data base may have been corrupted long before 


occurred 


"Current Task' may not have caused crash 
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Table 18-1 CDA Switches 


CDA Analysis Switches 


/ACT 
/CLOQ 
/DEV 
/HDR 
/PCB 
/POOL 
/STD 


/ALL 


Lists 
Lists 
Lists 
Lists 
Lists 
Lists 
Lists 


Lists 


/DUMP:a:b 


the 
the 
the 
the 
the 
the 
the 


the 


Lists the 
addresses 


/TASK=name:a:b 


TCBs for active tasks 

contents of the clock queue 

information on all devices in the system 
headers for all resident tasks 

PCBs 

contents of POOL 

contents of the STD 

output of all analysis routines 


contents of memory between the 18-bit 
a and b 


Lists the virtual space of task '"name' between the 
16-bit address a and b | 


Note: All analysis switches are used with the crash-input 


CDA Function Switches 


/LIMIT:n 


/MEMSIZ:n 


/STB 


Limits output listing to n pages 


Used on the list file 


Saves nK words of memory in a binary file 


Used on the binary file 


Identifies the symbol definition file 


Used on the STB file for the system 


259 


SYSTEM CRASHES 


Basic Information Provided in a CDA 


The KERNEL Stack and $STKDP 


e The KERNEL stack provides a record of the system entrances 
Since system state was entered 


e Each trap and interrupt causes task context to be saved on the 
KERNEL stack 


e SSTKDP indicates how many times context has been saved 
e Contents of stack can be partitioned by locating the saved PSs 


Each PS indicates the start of context saved by a trap or 
an interrupt 


PS on stack located by position on stack 


First entry on stack is PS from first trap or 
interrupt 


Next PS will be nine words further on stack if trap or 
fork occurred 


Next PS will be five words further on stack if 
interrupt occurred 


Context pushed because SST contains 11 words plus 
extra trap specific words 


If an SST occurred, it is always the last context on stack 


Contents of the APRs 
e Determines mapping between virtual and physical addresses 
KERNEL APRs show mapping when crash occurred 


USER APRs show mapping of current user task 
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SP — 


$STACK 


Figure 18-1 The Stack After a System Crash - IOT 
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SP) PC 
a 
RETURN TO $DIRXT 


PRO 
See | eee 
ee |) 
es 
es 
po RG 
po PS 


$STACK 


Figure 18-2 The Stack After a System Crash - EMT 
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SP o> BYTE COUNT 
FAULT CODE 


TRAP SPECIFIC 
DATA 


RETURN TO $DIRXT 


po RS 


$STACK 


Figure 18-3 The Stack After a System Crash - SST 
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Code 


ll 


16 


Number of Bytes 


4 


10 


14 
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Table 10-2 Fault Codes for SSTs 


SST Trap 


Traps through vector 4 (Odd address, 
etc.) 


Segment fault 

Trace or break-point instruction 
IOT instruction 

Illegal or reserved instruction 


Non~RSX EMT trap instruction 


Floating-point exception (11/48) 


2608 


KERNEL Stack Pointer 


Location 


889556 


GB956B 


986562* 


988564 
G0B566 
808576 
988572 
989574 
080576 
GBBEGB 
DBS6GB2 
GOCOG4 
BEAEBO 
G9H61B 
888612 


680614 


G8G616 


GBG620 
89622 
999624 
GBOG626 


989630 
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Contents 


924552 
80010 
BOBHHA 
GOOHBDO 
883129 
OBOBH1 
9786514 
974466 
853264 
144688 
BBPHBD 
121294 
G38GBB 
983126 
GBOBDO 
78514 
974460 
$5320 
144888 
GBOOBO 
121266 


1788689 


Example 19-1 


8899562 


PC at Crash 
PS at Crash SST Information 
Number of bytes 

SST Code 

Addr of S$DIRXT 

RG 

Rl 

R2 

R3 Context at SST 
R4 

R5 

PC 

PS 

ADDR of SDIRXT 

RG 

Rl 

R2 Context at Trap 
R3 

R4 

R5 

PC 

PS 


A Sample KERNEL Stack 
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AN EXAMPLE 


Situation 

@e Privileged task TT2 is executing. 
Task prompts for terminal number. 
User enters terminal number. 
System crashes. 
CDA prints message: 


Pool link error at 889848 -- FWD ptr = 960167 
Size = 981736 
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Output from CDA 


e Current task = RMDEMO 
Error indicates 


Error caused by another task 
Other task corrupted list of free pool blocks 


e Contents of KERNEL stack indicate crash caused by IOT 


Consistent with pool pointer = 989167 
Note that 998167 is JMP instruction and 981736 is location 
of $CRASH 

e Any recently or currently active privileged tasks may have 


caused crash 


e Examination of listing of task TT2 shows that task allocates 
and uses a block of pool 


Address of pool stored at location PLACE in task 


Task map indicates address of PLACE is 121436 


e Dump of task obtained from binary crash file 


Value of 954188 stored in PLACE 


e Examination of pool dump indicates 
Value @@8049 entered in 84 words starting at 954198 
Allocated block started at 9541988 and contained 84 bytes 


Error at location @80638 in task: MOV should be MOVB 
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RSX~-11M CRASH DUMP ANALYZER V4.0 1-NOV-81 11316 FAGE 1 
VOLATILE REGISTERS 

AFTER CRASH? FS=000340 SP (K)=000660 SP(U)=121164 

REFORE CRASH? FPC=141362 PS=030000 

RO=137034 R1=137034 R2=131120 R3=000000 R4=000167 R3=137014 
MMRO=000001 MMR1=000000 MMR2=002326 MMR3=000060 


USER UNI BUS MAF 

I SFACE i SPACE 1 00000000 
PDR FAR FIR FAR 2 00020000 
077506 000000 000000 000000 3 00040000 
077406 000200 000000 6000000 4 00060000 
077406 000400 000000 000000 2 00100000 
077406 0004600 000000 000000 & 00146200 
077408 001000 000000 000000 7 00166200 
077504 004732 000000 000000 8 17000000 
0335006 005132 000000 000000 ? 17000000 
077404 177600 000000 000000 19 17000000 


11 17000000 
12. 17000000 


SUFERVISOQOR 13 17000000 

14 17000000 

I SFACTCE tt SPACE 15 17000000 
FOR FAR FDR FAR 16 17000000 
000000 000000 000000 000000 17 17000000 
000000 000000 000000 000000 18 17000000 
000000 000000 000000 000000 19 17000000 
000000 000000 000000 000000 20 17000000 
000000 000000 000000 000000 21 17000000 
000000 000000 000000 000000 22 17000000 
000000 000000 000000 000000 23 17000000 
000000 000000 000000 000000 24 17000000 


209 17000000 
26 17000000 


KERNEL 27 17000000 

28 17000000 

I SFACE It SFACE 29 00045100 

PDR FAR FOR FAR 30 17760000 

077505 000000 000000 000000 31 00105100 
077506 000200 000000 000000 
077508 000400 000000 000000 
077406 000600 000000 000000 
077506 001000 000000 000000 
077506 004732 000000 000000 
077405 005132 000000 000000 
077506 177600 000000 000000 


Example 19-2 CDA - Volatile Registers 


264 


SYSTEM CRASHES 


X-11M CRASH DTIUMF ANALYZER 
RNEL STACK 


re 
hes 


KERNEL STACK 


000400 


000420 


000440 


000460 


000500 


000520 


000540 


000560 


900600 


000620 


000640 


00660 


0600700 


000000 


000000 


000000 


000000 


000000 


000000 


000009 


000000 


006110 


0246304 


000000 


003236 


170000 
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000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
133304 
001000 
000002 


000000 


V4.0 


000000 
000000 
000000 
000000 
000000 
000000 
000000 
131514 
044000 
131542 
000144 


136256 


_1-NOV-81 


000000 
000000 
000000 
000000 
000000 
000000 
000000 


131534 


140020 


060000 


131120 
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000000 
000000 
000000 
000000 
000000 
000000 
000000 


133054 


(132602 


133040 


036154 


000000 


11216 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


133036 


030000 


010024 


137014 


136320 


CDA - KERNEL Stack 


FAGE 2 


000000 
000000 
000000 
000000 
000000 
000000 
000000 
1231356 
026304 
011604 
141362 


134554 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


0014662 


001000 


124670 


030000 
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’ RSX-11M CRASH DUMF ANALYZER V4.0 1-NOV-81 11316 PAGE 3 
SYSTEM COMMON 


CRASH OCCURRED AT 11212327 1-NOV-81 


CURRENT TASK = RMDEMO TCR ADDRESS = 052110 


$SYSID = 31 $EXSIZ = 120000 $SYSIZ = 9216./288K $SYUIC = C154] 
$STKIF = 000000 $COMEF? <33-48> 000000 <49-64> 000000 

SYSTEM NAME = RSX11M $#NTUIC = C1954] 

LOAD DEVICE = [KO LEN = 00135325 FILE SIZE = 4964. 


SYSTEM FEATURE MASK (FIRST WORD) = 013377 


BIT SET MEANING 
EXT 22-BIT EXTENDED MEMORY SUPFFORT 
MUF MULTI-USER FROTECTION SUPPORT 
EXV 20K EXEC SUPPORTED 
DRY LOADABLE DRIVER SUPPORT 
PLA FLAS SUFFORT 
CAL DYNAMIC CHECKPOINT SPACE ALLOCATION 
FKT FREALLOCATION OF I/0 PACKETS 
EXF EXTEND TASK DIRECTIVE SUPPORTED 
OFF FARENT/OFFSFRING TASKING SUPPORTED 
FIT FULL DUPLEX TERMINAL DRIVER 
YM DYNAMIC MEMORY ALLOCATION SUPPORTED 


SYSTEM FEATURE MASK (SECONTI WORD) = 1467400 


BIT SET MEANING 
DFR DIRECTIVE PARTITION SUFFORT 
IRR INSTALL» REQUEST,» ANI) REMOVE TASK SUPFORT 
GGF GROUF GLOBAL EVENT FLAG SUFFORT 
RAS RECEIVE/SENT DATA PACKET SUF FORT 
REN ROUND ROBIN SCHEDULING SUPPORTED 
SWF EXECUTIVE LEVEL DISK SWAPPING SUFFORTED 
STF EVENT FLAG MASK IS IN THE TCR 


SYSTEM FEATURE MASK (THIRD) WORD) = 025214 


BIT SET MEANING 
CLI MULTIFLE CLI SUPFORT 
EIS SYSTEM REQUIRES THE EXTENDED INSTRUCTION SET 
STM SYSTEM HAS SET SYSTEM TIME TNTRECTIVE 
AST SYSTEM HAS AST SUPPORT 


Example 180-4 CDA ~- System Common 
(Sheet 1 of 3) 
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RSX-11M CRASH DUMP ANALYZER 


SYSTEM COMMON DUMP 


ALR 


007750 


007770 


010010 


010030 


010050 


010070 


LABEL 


SHEAR 
$COMEF 


$SYSI0 


$TKNET 
$SHFFT 
$CKCNT 
$CKCSR 
$CKLIC 
$SYUIC 


$EXSIZ 


$PURFL 
$SIGFL 
$LOGHD 
$MCRCE 
$LSTLK 


$CRAVL 


$ACTHE 
$UICSV 
$TKTCE 
$LBUIC 
$ARTIM 
$RQSCH 
SSTKOF 
$DEVHE 


$RNOCT 
$SWPECT 
$ERRET 
$CFLFT 


$INTCT 
$F RKHE 


$F MASK 


$HFMSK 
$F TTCE 
$PRISZ 
$POLST 


VALUE 


010316 
000207 
0352654 
160400 
000000 
000000 
030463 
020040 


110610 
111040 
172542 
172540 
000144 
000454 
000000 
120000 


000000 
000000 
000000 
000000 
000000 
000003 
046454 
000000 


117510 
001037 
032110 
000454 
041233 
000000 
000000 
040746 


000005 
000036 
000000 
050740 
006000 
026354 
be es 
000000 


010066 
013377 
167400 
025214 
000003 
112314 
033364 
000401 
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ALIIR 


010110 


010130 


010150 


010170 


010210 


010230 


Example 19-4 
(Sheet 2 of 3) 


V4.0 


LABEL 


$PRIHL 
$PRILL 
$PFRSZ 
$POLEF 
$POLFL 
$PARPT 
$CLKHDE 
$COPT 


$PARHDE 
$LORET 
$TSKHIO 
#XCOM1 
$XCON2 
$GGEF 

$GFTCE 
$GEFFT 


$GEFIM 
$I0LCT 


$IULPT 
$0 YFMN 


$BTMSK 


$ERHEA 


$ENTSQ 
$ERRSQ 
$ERFLA 


CDA - 
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1-NOV-81 11; 


VALUE 


003100 
001130 
000310 
000063 
000000 
017320 
045716 
043630 


117734 
117510 
117510 
001200 
001345 
000000 
010150 
010150 


000254 
000001 
170017 
020035 
020037 
020037 
017440 
017440 


020040 
000001 
000002 
000004 
000010 
000020 
000040 
000100 


000200 
000400 
001000 
002000 
004000 
010000 
020000 
040000 


100000 
000000 
010232 
000000 
000000 
000000 
000000 
000000 


system Common 


14 


ADDR 


010250 


010270 


010310 


010330 


010350 


010370 


FAGE 


LABEL 


$ERBAF 


$ERF IN 


$F RMOD 
$SYSIZ 


SOF 


4 


VALUE 


000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 


000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 


000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 


000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 


000000 
000000 
000000 
000000 
000000 
000000 
000106 
022000 


000000 
135325 
051104 
000760 
LLP LIE 
00001S 
000037 
000030 
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RSX-1iM CRASH DUMP ANALYZER V4.0 
SYSTEM COMMON DUMP 


ADLIR 


010410 


010430 


010450 


LABEL 


$TKFS 


$TTNS 
$TLMTS 


STIKLM 


VALUE 


000074 
000074 
000144 
000121 
000013 
000001 
000013 
000014 


000033 
000063 
000200 
000000 
000014 
000001 
000000 
000001 


000027 
000000 
000073 
000000 
000073 
000000 
000143 
000000 


ADDR LABEL 


010470 $PKAVL 
$PKNUM 
$MXEXT 
SUMRHD 
$UMRET 


SUMRWT 


010510 $TEMPO 
$TEMP1 
STEMP2 
$TEMP4 
SAVRHD 
$MOULS 
$CXDBL 
$SYSNM 


010530 
$CLICQ 


$CPTBL 


1-NOV-81 


VALUE 


054034 
002403 
177777 
000000 
170200 
000034 
000000 
010504 


111750 
052514 
130562 
000000 
000000 
047064 
000000 
051522 


030530 
046461 
000000 
010534 
010550 
052464 
000000 
000000 


11316 


ADDR 


FAGE S 


LABEL VALUE 


010550 $MCRFT 111750 


010570 


Example 19-4 . CDA - System Common 
(Sheet 3 of 3) 


268 


050712 
000000 
000040 
003404 
005015 
000076 
005015 


041515 
037122 
000000 
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RSX-116 CRASH DUMF ANALYZER 
SYSTEM COMMON ALFHABETIZED 


$ABTIM 
$ACTHE 
$AVRHE 
$CFLET 


$CKCNT 


$CKCSR : 


$CKLOC 


$CLICQ 


$CLKHOE 


$COPT 


CP TBL 


$CRAVL 


$CURPR 


$CXDRL 


$DEVHI 


$OICSYV 


$0FM 


$ENTSQ 


FE RRAF 


$ERF ID 


$ERFLA 


$ERHEA 


041233 
117510 


000000 


000144 
000000 
045716 
043630 
010550 
046464 

341 

000 
040746 
001037 
000037 
000000 

000 
000000 

000 


000000 
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$ERLOF 
$ERRFT 
$ERRSQ 
$EXSIZ 
$F MASK 
$F RKHDE 
$GEFIM 
$GEFFT 
$GFTCEH 
$GGEF 

$HEATR 
$HFMSK 
$I0LCT 
$1 0LFL 
$IULPT 
$INTCT 
$LBUIC 
$LORET 
$LOGHD 
$LSTLK 
$MCRCE 


$NCRET 


V4.0 


DUMP 


000 


000000 


000000 


120000 


013377 


000000 


000254 


0101350 


010150 
000000 


000 


170017 


177777 


000454 


117510 


000000 


000000 


000000 


111750 
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1-NOV-81 


$MOULS 
$MXEXT 
#NTUIC 
$FPARHII 
$PARFT 
$PFRSZ 
$FRAYL 
$PKMAX 
$PKNUM 
$FOLBPF 
$F OLFL 
$F OLST 
$F RIHL 
$PRILL 
$F RISZ 
$F RMOL 
$F TTCR 
$F WRF L 
$RNICT 
#RQSCH 
$SHFFT 


$SIGFL 


CDA - System Common 


047064 


177777 


000454 


117734 


017320 


000310 


O354034 


005 


003 


000063 


000000 


000401 


003100 


001130 


033364 


000106 


112314 


000000 


000005 


000000 


111040 


000000 


FAGE 6 


$STKOF 
$SWPCT 
$SYSIZ 
$5 YSNM 
$SYUIC 
$TEMFO 
$TEMF IL 
$TEMF2 
$TEMFA 
$TKNET 
$TKFS 

$TKTCE 
$TSKHD 
$TTNS 

$UMRHII 
$UMRFET 
$UMRWT 
tWICSR 
$WTOUM 
$XCOM1 


$XCOM2 


Alphabetized Dump 


000000 
000036 


022000 


130562 


000000 


110610 


000063 


000000 


170200 


000000 


017320 


017320 


001200 


001345 
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RSX-11M CRASH DIUMF ANALYZER V4.0 1-NOV-81 11316 PAGE 7 
FOOL STATISTICS 


Fool link error at 000040 -~- FW rtr = 000167 Size = 001736 


FOOL SIZE (BYTES) = 213764, 
LARGEST FREE BLOCK (BYTES) = 36. 
TOTAL FREE BYTES = 144, 

NUMBER OF FRAGMENTS = 13. 


MINIMUM BLOCK SIZE (BYTES) = 4. 


FOOL BITMAF (CONSTRUCTED FROM LINKED FOOL,» BLOCK FREE IF BIT SET): 


000000 000000 060000 002014 000000 000000 000200 001000 
000000 001400 000000 000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 000000 000001 000000 
000000 000000 000000 000000 000000 000000 000000 000000 
000000 000000 000000 007600 002000 000000 000000 000000 
000000 170000 000037 000000 003400 000000 000000 900000 
017740 000000 000000 000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 000000 000000 000000 
C00000 §=000000 «000000 «6000000: 6000000) 6000000) «69000000 «6000000 
000000 000000 000000 000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 000000 9000000 000000 
900000 000000 000000 000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000) 000000) 000000 000000 
000000 000000 000000 000000) 000000) 000000) 000000) 000000 
000000 000000 000000 000000 000000 000000 9000000 000000 
000000 000000 000000 000000 000000 000000) 9000000) 000000 
000000 000000 000000 000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 000000 000000 000000 
000000 000000 000000 0600000 000000 000000 600000 000000 
000000 000000 000000 000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 000000 900000 000000 
000000 000000 9000000) 000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 000000 000000) 000000 
000000 000000 000000 0600000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 000000 000000 000000 
000000 000000 900000 000000 900000 000000 000000 900000 
000000 000000 000000 000000 000000 000000 000000 000000 
000000 000000 000000 000000 000000 600000 600000 000000 
000000 8000000) 000000 000000 000000 000000 000000 000000 
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RSX-11M CRASH DUMF ANALYZER 
FOOL STATISTICS 


000000 
000000 
000000 
000000 
000000 


000000 
000000 
000000 
000000 
000000 


Example 19-6 


000000 
000000 
000000 
000000 
000000 


V4.0 


000000 
000000 
000000 
000000 
000000 


CDA - 


000000 
000000 
000000 
000000 
000000 


POOL 
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1-NOV~-81 11216 
000000 000000 
000000 000000 
000000 000000 
000000 000000 
000000 

Statistics 


PAGE 8 


000000 
000000 
000000 
000000 


RSX-11M CRASH DUMF 


ACTIVE TASKS 


TCR ADRESS = 054440 


SYSTEM CRASHES 


ANALYZER 


PAR 


LOAD ANDRESS = 00440400 


PRI = 50. 
MAX SIZE 
T.STAT? 
T+ST23 
T.ST3! 
T.TIO? 
TCR DUMP? 
000000 
000020 
000040 


000060 
000100 


I/0 COUNT = 1. 


= 000031 


-CHK WFR 
-PMD REM 


000000 


000000 
054456 
000062 
000031 
054536 


EVENT 


FRY MCR 


000462 
000000 
117403 
047102 
000000 


V4.0 


= GEN 


UI 


FLAGS = 


000000 
000000 
0446166 
047102 
000001 


Example 108-7 CDA 


LOAD DEVICE = 


1-NOV-~-81 


SYO% 

C = C7377) 
=1-16> 000000 
100100 000000 
0442546 007754 
OS5174 000031 
000000 000000 
054462 000000 


- Active Tasks: 
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11316 


PAGE 19 


FCR ADDRESS = 055174 


LBN = 00117403 


TI = TT2? 

“17-32 000000 
000000 054452 
000000) 020001 
111404 000000 
000000 054532 


Le 


000000 
074000 
000000 
000000 


SYSTEM CRASHES 


RSX~-11M CRASH DUMF ANALYZER V4.0 1-NOV-81 11316 F 
TASK HEADERS 
000040 000000 000000 055102 000001 126202 000000 000000 
000060 000376 000000 000000 000000 000000 055144 600007 
000100 000000 042360 000000 043630 000000 0461646 000000 
000120 000000 046116 000000 046072 000000 000001 053654 
000140 132277 046430 000123 000000 000612 051006 170000 
000160 000000 177777 044000 000000 000056 120533 000000 
TT2 
HEADER ADDRESS = 054554 TCE ADRESS = 054440 
FS=170000 FC=122200 
RO=000000 R1=054350 R2=044336 R3=000001 R4=000001 R5=000060 
INITIAL FS = 170017 INITIAL FC = 121442 INITIAL SP = 121172 
HEADER SIZE = 122. NO. OF WINDOWS = 1. NO. OF LUNS = 
CURRENT UIC = C7377) DEFAULT UIC = £7377] 
H»WNIE = 054702 H-GARD = 054744 H-VEXT = 000000 H.SPRIO = 
NSW = 000001 H.«FCS = 000000 H«FORT = 000000 H-OVLY = 
LOGICAL UNIT TABLE: 
* DEY WINDOW W.CTL W.FCR F.FNUM F.FSEQ F.STAT NAC NLCK 
1 SYO? 000000 
2 SYO? 000000 
3 SYO} 000000 
4 SYO? 000000 
Y TIO? 000000 
6 CLO? 000000 
WINDOW BLOCKS? 

FAR VIRT LIMITS ATT DESC WN SIZE OFFSET 1ST FOR NO. L 
GEN 120000 123077 047074 000031 000000 177612 1 
HEATER ¢ 

000000 121172 000172 053254 135600 003777 003777 170017 
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TT2 


AGE 30 


000000 
046072 
046072 
120000 
124636 


SP=121172 


Log 
mane © 


000000 


AST FIR 


014006 


121442 


SYSTEM CRASHES 


RSX~-11M CRASH DUMF ANALYZER 


TASK HEALERS 


000020 
000040 
000060 
000100 
000120 
000140 
000160 


121172 
000000 
000373 
000000 
000000 
000031 
6000001 


Example 19-8 


000000 
000000 
000000 
046166 
046116 
000000 
044336 


V4.0 
000000) =000000 
054702 000001 
000000 = =000000 
000000 046166 
000000 000001 
000612 014006 
054350 000000 
CDA 


- Tasks Headers: 
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~NOV-81 


000000 
000000 
000000 
000000 
055174 
170000 
000000 


11316 


000000 
000000 
054744 
046166 
120000 
122200 


FAGE 31 
000000 000000 
000000 = 000000 
000006 046166 
000000 046072 
123077 047074 
000060 000001 


TT2 


SYSTEM CRASHES 


RSX~-11M CRASH DUMF ANALYZER 


FOOL DUMF 


053260 
053270 
033300 
OS3310 
0353320 
053330 
053340 
053350 
053360 
053370 
053400 
053410 
053420 
053430 
053440 
053450 
053460 
053470 
053500 
033510 
OS3520 
0535390 
O53549 
053550 
053560 
053570 
053400 
053610 
053620 
0336390 
053640 
053650 
053660 
033670 
O33700 
053710 
05372 

033730 
053740 
053750 
033760 
053770 
054000 
OS4010 
034020 
054030 
054040 
054050 
054060 
054070 
054100 


Ms MMM HM HM HM 


RM MMM MM HM HMM HMM KKH HM 


Breet te HRM HHH MM KM KM HH 


114250 
000000 
000401 
000016 
000401 
114730 
0646117 
000033 
053640 
000000 
053640 
000403 
000000 
143107 
170017 
000000 
000000 
OS3552 
143142 
000000 
000006 
000000 
000000 
000000 
144277 
001212 
1753577 
000616 
000000 
0000460 
054224 
000403 
026226 
004078 
000000 
000000 
000000 
0073537 
053736 
054440 
000062 
000306 
000306 
000000 
054016 
000000 
000020 
135154 
003077 
000000 
000040 


000040 
000040 


ha bo 


V4.0 1-NOV-81 =. 11216 
x 053276 * 000001 x 115404 !xXQ MSF A 
k 000106 * 114250 x 000000 $$! AO XQ 
* 115404 * 000000 x 001000 ! FQ x2n 
* 121350 x 000000 * 000000 ! N ZREX 
k 000000 * 000000 xk 000000 =! FQ 
K 121246 * 000000 x 000000 !Xxx Z 8 
x 131574 * 000000 xk 000000 'QMG ... 
* 000000 * 000000 x 000000 ! ¢ 
000044 111404 041740 !N 2 6 WTS 
000000 000001 1114246 ! A 
000024 000000 000000 IN 2 T 
000000 §=053640 =9000010 =! FS N 2 
000000 * 120412 x 000212! YOZ 
x 000000 * 000454 xk 000454 !1.9 GT 
k 120750 kK 120412 k 000000 !8F0 Y6H YOZ 
* 000000 * 000000 x 000000 $s! 
x 000000 * 000000 x 000000! ; 
* 000002 k 143030 k 000000 'M9R  B 182 
* 000000 * 000373 x 000000 !1/Z FK 
* 000000 xk 000000 * 053634 =! 
K 046166 * 000000 k 043630 ! F LIN 
k 041006 * 000000 k 0461646! JVy 
* 046072 * 000000 * 0461146 =! LG4 
K 000002 * 046674 * 120000! B LQT 
x 052360 k 000243 x 000000 !201 MWX IC 
k 021006 k 115404 * 160000 ! FJ EQO Xx2n 
x 053270 * 000156 * 000147 ! IW M5 B&O 
x 066402 & 170000 k 121016 ! I8 QQZ BF 
* 000000 * 143107 xk 000060 $$! 1.9 
K 120431 * 000000 k 000000 =! AH YiA 
000014 000000 000000 '!NF& L 
000000 * 054374 xk 000062 ! FS NIT 
x 000000 * 055174 * 115274 !GEN NSU 
K 000123 k 000000 k 000123 'ALO EC 
* 111404 x 000050 * 054750 =! WTS A 
* 046430 k 046430 * 000000 =! LMF LMF 
k 000062 * 000000 x 131574 =! AJ 
* 000000 * 053732 * 000000 ! BRO NBJ 
* 177776 * 000001 * 044000 '!NEN 8N~ A 
* 100400 k 020000 * OS0000 INJF TYX ELI2 
x 142440 * 0446142 * 115274 |! AJ 1UX LH4 
* 054440 x 000000 * 000000 =! U8 NUF 
k 000000 * 054002 x 000000 =! ng NCJ 
k 000000 *k 054012 xk 000000 =! NCR 
* 000000 k 000003 * 053742 I NCY Cc 
x 000000 + 055240 + 000044 =! NT 
+ 000000 + 044416 + 000400 ! F KV 
+ 005103 + 140054 + 000000 !/3D AY$ 0/74 
+ 140144 + 000070 + 000000 'AYW O1L AF 
+ 000000 + 000000 + 000000! 
x 000040 * 000040 x 000040 ! 2 2 2 
CABOVE LINE REPEATED 9. TIMES] 
x 000040 000040 000040 ! 2 2 
000040 000040 000040 ! 2 2 
Example 18-9 CDA - POOL Dump 
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FAGE 82 


SYSTEM CRASHES 


RSX-11M CRASH DUMF ANALYZER 


FOOL DUMP 


054240 
O54250 
054260 
054270 
054300 
054310 
054329 
054330 
054340 
054350 
054360 
054370 
054400 
054410 
054420 
054430 
054440 
054450 
054440 
054470 
054500 
054510 
054520 
054530 
054540 
0545590 
054560 
054570 
054400 
054610 
054620 
054630 
054640 
054650 
054660 
054670 
054700 
054710 
0354720 
054730 
054740 
05475¢ 
054760 
054770 
035000 
OS5010 
0355020 
055030 
OSSO040 
O355050 
055060 
wuO70 
035100 
OS5110 
O5S120 
055130 


He HH HM HM HH HHH HM HMM HMM HHH HMM HMMM MEK MMH MH M HM HM HM HM HM HH HM HM HMM HM HMM HMM HM HMMM HM 


000040 
000040 
000040 
000040 
000040 
000040 
000040 
000040 
000040 
170000 
000004 
000000 
111404 
121246 
000005 
000000 
000000 
000000 
054456 
007754 
000062 
000031 
000031 
000000 
054536 
000000 
053254 
170017 
000000 
000000 
054702 
000000 
000000 
000006 
000000 
000000 
000000 
123077 
000612 
000060 
054350 
120502 
000454 
120506 
000000 
000000 
126202 
000376 
000000 
000000 
000000 
000000 
000000 
132277 
000612 
000000 


000040 
000040 
000040 
000040 
000040 
000040 
000040 
000040 
000040 
125200 
130034 
000000 
055050 
004110 
140111 
100000 
000462 
000000 
000000 
000000 
117403 
111404 
047102 
000000 
000000 
001000 
135600 
121442 
000000 
000000 
000001 
000000 
000000 
046166 
046166 
046072 
000001 
047074 
014006 
000001 
000000 
000176 
000454 
000000 
000000 
000000 
000000 
000000 
055144 
042360 
046166 
046116 
000001 
046430 
051006 
177777 


MM HM HM HM HM HHH HM HH HM MM HM MM HM HM HMM HM HM HW HM HM HM HM HM HM HM HM MM HM MM HM HM MM MMM MM MMM HM HM 


Example 


V4.0 


000040 
000040 
000040 
000040 
000040 
000040 
000040 
000040 
000040 
127542 
131100 
000000 
044000 
140046 
0000356 
000000 
000000 
054452 
000000 
020001 
046166 
000000 
047102 
OSASS2 
000001 
121172 
003777 
121172 
000000 
000000 
000000 
000373 
000000 
000000 
000000 
000000 
035174 
000031 
170000 
000001 
000000 
140354 
170017 
000000 
000000 
O55102 
000000 
000000 
000007 
000000 
000000 
000000 
053654 
000123 
170000 
044000 


Se HH HH MH HH MH MH HM HHH MH MH HHH HM HM HM HM HM HM HM HM HM HH MH HM HM HM HM HMM MM HM MM HM HM HM MM MH 


18-9 


1-NOV~-81 


000040 
000040 
000040 
000040 
000040 
000040 
000040 
000040 
000040 
000000 
000110 
000773 
000540 
-000000 
000000 
053654 
100100 
000000 
044256 
074000 
O55174 
000000 
000000 
000000 
054462 
000172 
003777 
000000 
000000 
000000 
000000 
000000 
0354744 
046146 
0461656 
046116 
120000 
000000 
122200 
044336 
120424 
135600 
121714 
000000 
000000 
000001 
000000 
000000 
046072 
043630 
046072 
046072 
120000 
000000 
124636 
000000 


Fe MM MH MM HM HH HM MMM HM HM HM HM HMM MM HM HM HMM HM HM HM HH HM HMM HM HM HM MM HM HMMM MMM MM HMM HK 
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MAE SENESES ENE SEES) 


11316 


PoP RIP PhS Po ho bo 


+ & 
a gs 
Lan a 
*- + 
4+ 


FK 


80 


CDA - POOL Dump 


Al! 
A 

1! 
LG4!! 
KRH! ! 
LG4!! 
LG4!! 
YX !! 


FAGE 83 


&°H &@ 


“ } . 
< 


8] 
=< 


! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
! 
PoovkL 
ove 
! th 
! ! 
1? RN ! 
! er $l 
10 
!hx 
IRI” 1@ »#! 
ly » ple! 
IF I 


! H 


LLE 


UME 


30 
31 


rr 


MACKO M1200 


000000 


000000 
000008 
000006 
O00011 
000014 
000017 
000022 
000025 
000030 


000033 
000036 
00004] 
000044 
000047 
000052 
Q0005S 
000060 


000062 
000065 
000070 
000073 
000076 
OOO101 
000104 
000107 
OOO LS 
QOONLS 
000120 


O1L-NOV~-8t 
012 OLS 
114 124 
122 040 
040 124 
122 115 
114 101 
040 114 
115 102 
122 O72 

000033 
103 114 
10% 122 
101 040 
117 113 
101 114 
O40 106 
122 040 
103 122 

000027 
116 125 
102 10% 
O40 Lit 
040 1164 
124 040 
103 124 
114 On4 
124 122 
OAD 101 
101 Lid 
O41 

OOOOS7 
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L109 


LOS 
105 
101 
105 
Lid 
114 
125 
105 
040 


124 
040 
103 
115 
104 
117 
115 


11s 
122 
123 

117 
117 
101 
040 
131 
107 
L1é 


PAGE 3 


+ 


“E> “a> “EP “G> “E> ED E> EP “E> E> > E> Od EP “Em E> “E> “E> “E> “er 


+ 


FPLIEN 
MES13 


LENTIL 
MESS13 


LENA 


TITLE =tUMF 


THIS TASK ASKS THE USER FOR A TERMINAL NUMBER ANI A 
COMMAND LINE. IT THEN FASSES THE COMMANI! TO MCR 

AS IF HAL ORIGINATED AT THE SPECIFIED TERMINAL. IT 
FERFORMS THIS TASK BY USING SYSTEM SUBROUTINES: #ALOCK 

AND ¢QMCRL» TO ALLOCATE A BLOCK FROM FOOL AND FASS IT 

TO MCR, 

THE TASK MUST BE BUILT PRIVILEGED ANI MAF TO THE EXECUTIVE. 
TO ASSEMBLE’ 

>MAC TERM=C1* 1.0 EXEMC/ML »CilyLOIRSXMC/PAS Ly CCYOUR UIC) ITERM 
TO BUILD 

“TRE TERM/FE Ri S=TERMs CL» S4IRSXi1M.STB/SS 

*MCALL EXITSS es QIOWSSy DCROFS 

NCEDFS 

TERMINAL MESSAGES 


*ASCTIT 2122<152/ENTER A TERMINAL NUMBER: / §PROMPT 


= oo PRMT ILENGTH OF FROMFET 
“ASCII /ENTER A COMMAND FOR MCRZ 


= +o MES 
+ASCII /NUMBER IS NOT OCTALy TRY AGAIN! 


s MESS 


Listing of Task TT2 (DUMP) 
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SHHSVYO WHLSAS 


BL¢ 


DUMP 


33 


36 
37 


MACRO M1200 O1-NOV-81 112309 FAGE 3-1 


000121 
000124 
000127 
000132 
000135 
000140 
000143 


000144 
o0o0l4a?7 
000152 
OOoO1SS 
000160 
000163 


G00166 
ooo171 
000174 
000177 
000202 
000205 
000210 
000213 
000216 


000220 
000224 
000230 
000232 
000234 
000236 
000240 
000242 
000244 
000246 


0002530 
000322 
000374 
000400 
000404 
000408 


000412 
OOO4LA4A 
N00416 
000422 
000426 
000432 
000434 


124 
115 
101 
116 
040 
125 
O41 
000023 
116 
120 
114 
126 
114 
114 
000022 
111 
040 
122 
040 
040 
115 
116 
111 
125 


000032 


124 
177777 
000000 
000000 
000000 
000000 
000000 
000000 


016703 
012700 
005002 


005702 
001402 
000167 


012700 
011000 
001422 


105 122 ERMES: 
111 116 
114 040 
117 124 
106 117 
116 104 
ERL 
117 040 FOOL? 
117 117 
040 101 
101 111 
101 102 
105 041 
PL 
057 117 IOERR: 
105 122 
117 122 
117 116 
103 117 
115 101 
104 040 
116 120 
124 
IOL. 
5 
; 
5 
RUF 3 
TOSE3 
124 NAM? 
ERRCNT: 
COMM: 
FLACE$ 
UCE?: 
ICES: 
LOW: 
HIGH: 
, 
, 
y 
TERM: 
177626 
000220’ 
000436 
CONT: 
0000006 
Li: 


Example 19-190 


*ASCITI /TERMINAL NOT FOUNT!/ 


= + ERMES 
“ASCII /NO FOOL AVAILARBLE!/ 


i] 


+~FPOOL 


“ASCII !1I/0 ERROR ON COMMANI! INFUT! 


= «~IOERR 
«EVEN 


FROGRAM LIATA 


+ BLAKE 4 

»BLRW 2 

*ASCII /TT/ 
+ WORE “1 

«WORD 1?) 
+WORT 0 
WORE 0 
*WORD 0 
»WORT 19) 
«WORT! 0 


BEGINNING OF CODE 


QIOWSS FIO WVEs £52 tle eyo EP RMT oe SPLEEN $402 


*MAKE SURE OF WORT BOUNDARY 


*BUFFER FOR TERMINAL NUMBER 

*I/0 STATUS BLOCK 

sTERMINAL NAME 

sERROR INDICATOR 

sADTIRESS OF COMMANID LINE IN FOOL 
sANTIRESS OF FOOL BLOCK 

sSAVET) UCK ANDRESS 

*SAVER DCH ALTIRESS 

sSAVED LOW UNIT NUMBER 

¥SAVEDT HIGH UNIT NUMBER 


sPROMFT 


QIOW$S #FIO.RVEstSr tis se tlOShy » RUF #4> FGET “TT’ NUMBER 


MOV TOSE+2 9R3 
MOV FRUF »RO 
CLR R2 

CALL. $COTR 

TST R2 

REQ CONT 

JMF ERR1L 

CALL $SWSTR»BRACK 
MOV FSNEVHE RO 
MOV (RO) »RO 
BEQ GO 


Listing of Task TT2 
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§SAVE CHARACTER COUNT 

gSET UF FOR CALL TO CONVERSION 

ROUTINE - FROM ASCII TO 
BINARY (COCTAL > 

Ri WILL CONTAIN CONVERTED NUMBER 
R2 WILL CONTAIN TERMINATOR 

yTEST FOR ERROR 

*IF NOT CONTINUE 

*GO TO ERROR ROUTINE 

99SWITCH TO SYSTEM STATE 

seFICK UF LISTHEADT FOR NCB LIST 
?7GO TO NEXT LCR 

?¢IF NONE FINISH UF 


> er “er “a> “ed 


(DUMP) 


SHHSVYO WALSAS 


6L2 


XiUME MACRO ML200 O1-NOV-S4 11209 FAGE 3-2 


yLOOK FOR “TT’ DIC 


71 000436 26760 177566 000004 CMF NAM sT. NAM CRO) a» 

72 000444 001372 RNE Li $9IF NOT ‘TT’ GET NEXT BCR 

73 000446 116067 000006 177570 MOVE DeUNLT CRO) » LOW >3GET LOW UNIT NUMBER 

74 0004354 116067 000007 177564 MOVE ReUNTT+1 (RO) sHIGH $§GET HIGH UNIT NUMBER 

75 000462 020167 177560 CMF Ri»yHIGH SSCOMPARE INFUT WITH HIGH 

76 000466 003361 BGT La 99IF TNFUT LARGER GET NEXT DOCK 
7? 000470 010067 177546 MOV RO TCR I9SAVE NCKR ANLRESS 

78 000474 0462767 000001 177530 ALT #17 ERRONT SS INIICATE NO ERROR HERE 

79 000502 GO? RETURN seRETURN TO USER STATE 

80 000504 BACK3 yNOW IN USER STATE 

81 000504 005767 177522 TST ERRONT sTEST FOR ERROR 

82 000510 001402 BEQ 1% SCONTINUE IF OK 

83 000512 000167 000430 JMF ERR2 §G0 TO ERROR ROUTINE 

84 0005146 016700 177520 1$3 MOV TICK y RO §GET TCR ANMRESS 

85 000522 016002 000002 MOV TeUCKCRO) eR2 §GET ALMIRESS OF FIRST UCE 

86 000526 010104 MOV RivR4 sMOVE FOR CALCULATIONS 

87 000530 166704 177510 SUB LOWsR4 sFINI THE NUMBER WITHIN UCBS 
88 ¢ FOR CURRENT DICK 

89 000534 0146005 000010 MOV Le UCBL CRO) » RS *GET UCE LENGTH 

90 000540 070504 MUL. R49RS SCALCULATE OFFSET FOR UCK 

91 000542 060502 AU RSrR2 sCALCULATE BEGINNING OF UCE 
2.000544 010267 177470 MOV R2»UCK *SAVE UCR ANDRESS 

93 000850 012767 177777 177454 MOV #-1 2 ERRCNT #RESET ERROR COUNT 

94 000554 CALL $SWSTK ye RACK? +9SWITCH TO SYSTEM STATE 

9S 000562 012701 000124 MOV #84. 9R1 §9SET RLOCK SIZE 

96 0005466 CALL SALOCKE FFALLOCATE BLOCK FROM FOOL 

97 000572 103404 BCS NONE §9NO ROOM IN FOOL. 

98 000574 005267 177432 INC ERRCNT Pe INDICATE NO ERROR HERE 

99 000600 010067 177432 MOV RO»PLACE 99SAVE ALDRESS OF FOOL BLOCK 

L100 000604 NONE $ RETURN ssRETURN TO USER STATE 

101 000606 RACK23 gRACK IN USER STATE 

102 000606 005767 177420 TST ERRCNT §CHECK FOR ERROR 

103 000612 001402 BEA 1% sCONTINUE IF OK 

L104 000614 000167 000406 JMF ERRS 9G0 TO ERROR ROUTINE 

105 000620 012700 000124 1$% MOV #E4.9R0 *SET LENGTH OF BLOCK 

106 000624 016701 177406 MOV PLACE »Rt sGET ADTIRESS OF BLOCK 

107 000630 012721 000040 2b e MOV #40y CRA + gFLACE BLANKS IN BLOCK 

108 000634 077003 SOR ROr 26 SLOOP UNTIL THROUGH 

L109 000636 016767 177374 177370 MOV PLACE » COMM SCALCULATE LOCATION OF COMMAND 

110 000644 062767 000004 177362 Atn #4°COMM § LOCATION IN BLOCK 

Lid 000652 QIOWSS #FIO.WVBe tS F197 eS EMESL  SLENTI #402 gFROMFPT FOR COMMANI! 

112 000724 008067 177274 CLR LOSE ICLEAR THE I/70 STATUS ~- WORD 1 

113 000730 005067 177272 CLR TOSK+2 ; * : . - WORE 2 

LtL4 O00734 QIOWSS #10. RVBs #59 #192 TOSBy e COMM? #80. > sINFUT COMMAND 

115 001006 103002 BCC 3s sCONTINUE IF OK 

116 QOOL01O 000167 000272 JME: ERR4 SRRANCH ITF QI0 ERROR 

t17 001014 105767 177204 3H 8 TSTE IOSE sCHECK FOR I/70 ERROR 

118 001020 002002 BGE 4$ sCONTINUE IF OK 

119 QO1022 000167 000260 JMP ERR4 ¥RRANCH IF ERROR 

120 001026 ASS CALL $SWSTK » BACKS §FSWITCH TO SYSTEM STATE 

124 001032 016701 177200 MOV FLACE » RA g9GET ADDRESS OF BLOCK 

122 001036 016761 177176 000002 MOV UCEy2¢°R1) sePLACE UCK ADDRESS IN BLOCK 

125 001044 CALL. $QMCRL §sQUEUE BLOCK TO MCR 

124 OO10S0 RETURN : 99LEAVE SYSTEM STATE 

125 001052 RACKS 3 SHACK IN USER STATE 

124 001052 EXIT#$S yEXIT 

127 5 


Example 18-18 Listing of Task TT2 (DUMP) 
(Sheet 3 of 5) 


SGHSVWYO WALSAS 


Q8C 


DUMP MACRO M1200 O1-NOV-81 11309 FAGE 3-3 


ROUTINE TO HANDLE BAD TERMINAL NUMBER 


128 3 

129 ; 

130 001060 ERR: QIOWSS FIO.WVB #59 F199 9 ec EMESS1 e $LENI ¥ #407 SPRINT MESSAGE 
131 001132 612700 000220’ MOV . FBUF ey RO sGET INFUT BUFFER ADDRESS 

132 001136 005020 CLEAR: CLR CRO+ sCLEAR BUFFER 

133 001140 077302 SOR R3rCLEAR gR3 CONTAINS CHARACTER COUNT 
134 001142 0001467 177102 IMF TERM eTRY AGAIN 

135 ; 

136 i ROUTINE TO HANDLE NON-EXISTENT TERMINAL 

137 ; 

138 001146 ERR23 QIOW$SS FIO WV y Fy tly ey eS HERMES> ERL 2 $407 SPRINT MESSAGE 
139 001220 EXIT$S yEXIT 

140 ; 

141 ; ROUTINE TO HANDLE FOOL ALLOCATION FAILURE 

142 5 

143 001226 ERR: QIOW$S FIO.WVR ry #5981 eee oP OOLy SFL F407 sF RINT MESSAGE 
144 001300 EXITS yEXIT 

145 ; 

144 ; ROUTINE TO HANTILE I/O ERRORS ON COMMANT! INFUT 

147 ; THE FOOL BLOCK MUST BRE DEALLOCATED! 

148 ; 

14? 001306 ERR4;: QIOWSS FLO WVBR tS etl sey re FIOERR ye FI OL s $407 sFRINT MESSAGE 
150 001360 CALL $SWSTKrFIN sISWITCH TO SYSTEM STATE 

1541 001364 016700 176646 MOV FLACE r RO 79GET ARDIRESS OF BLOCK 

152 001370 012701 000124 MOV #84.9R1 99SET BLOCK LENGTH 

153 001374 CALL $HEACK PITIEALLOCATE BLOCK 

154 001400 RETURN yxLEAVE SYSTEM STATE 

155 001402 FING RACK IN USER STATE 

156 001402 EXIT$S yEXIT 

157 000250’ «ENT! TERM 


Example 19-18 Listing of Task TT2 (DUMP) 
(Sheet 4 of 5) 


SHHSVYO WaHLSAS 


T8¢ 


CUMF 
SYMBOL. 


ATSERTO= 
ASSERT = 
OS$(CHh= 
AVE BCL Le 
AB SOP Ses 
ASENG T= 
ASSPR Is 
OB ST RE ze 
GACK 
BACK2 
LACKS 
UF 
RS$LV Ls 
GS$LVQ= 
CLEAR 
COMM 
CONT 
Cé$Cnaz 
CeECHEs 
CBS COKE ee 
CS $CSF ss 
CBS INT = 
C&S$0ONG= 
CE$QORE = 
CO$OTM= 
C&S RSH 
(OB SRUNE 
$$ SM Tee 
$$ TTY 
Dk 
Li$$H11= 
$$ TAG: 
Qibb SWe 
YUS $l. 7 1s 
Tih MAL iL = 
is $r Abe 
Tub & SS HIF == 
ib $WOKE 
TiS SYNC: 
Vis $ YNM== 
i. 0SF 
Nie LNK 


+ ABS. 


ERRORS DETECTED: 


MACRO M1200 
TABLE 


000000 
000000 
000000 
000004 
000000 
000000 
000000 
000000 
OOOSO4R 
000606R 
OO1L0S2K 
OOQO220R 
030463 
020040 
OOLLIGE 
00023 4K 
000422R 
000002 
000000 
O00004 
177404 
000000 
000001 
002022 
000000 
177564 
000000 
000000 
177564 
000242R 
000001 
000000 
000000 
000002 
000001 
000000 
000000 
000000 
000000 
00QQ00 
000012 
000000 


000036 
001410 


O1-NOV-8 1 


000 
O01 


VIRTUAL MEMORY USED: 


NYNAMIC 
ELAPSIEL 


MEMORY 
TIME: 


D4MSK 
t.NAM 
DL.FCR 
D.uCE 
n.UCKL. 
D.UNIT 
te VCAN= 
OU. VIE Bs 
U.VINT= 
0. Vout= 
th. VEWF 
ERL. 
ERMES 
ERRCNT 
ERR 
ERR2 
ERR3 
ERR4 
ES$ACT= 
ES$0VC 
ES$LO0G= 
EGSXPR= 
FIN 

FOS Pps 
FS$LVUL= 
Go 
GSsEFN= 
GS$$TPF= 
G$S$TSS= 
GS$TTK= 
HIGH 
H$$RT Zs 
IOERR 
IO. 
IOSK 
TO. RVEe 
TO. WUE: 
I$$RAR= 
TS$R0Ne 
K$$AST= 
KS$CNT= 
K$$CSk= 


10113 WORDS 
16120 WORDS ¢ 
00300313 


11209 


000014 
000004 
000034 
000002 
000010 
000006 
000002 
177776 
000000 
000004 
000006 


= QO0023 


000121 
O00232R 
001060K 
001146K 


.001226R 


001306R 
000000 
000000 
000000 
000000 
001402R 
000000 
000001 
000502R 
000000 
000000 
000000 
000000 
000246K 
000074 
000166R 


= OO0032 


000224K 
KKKKKK GX 
KKKKKK GX 
000000 
000000 
000000 
172542 
172540 


62 FAGES) 


FAGE 


( 40 PAGES) 


KS$TEN= 


LOS$CQ = 
LUStE = 
LOSOK = 
LOSE = 
LOStM = 
LOGO = 
LOoéns 
LUSsnt 
LISLE 
LIMsMM 
LOSTT 
LENTIL 
LEN1 
LOW 
L&ésASG= 
LS$0RVU= 
LS$Liike= 
LS$F TOs 
L$éPil= 
Li. 
MESS1 
MES1 
M$$CRE= 
M#S$CRX= 
MS$SEIS& 
M$$EXT= 
ME$FCS= 
M$$MGE= 
MESMUPF oe 
M$$OVUR= 
NAM 
NONE 
Né$L00V=: 
Né$MOVE 
NS$UMR= 
PL. = 
FLACE 
FLEN = 
FOOL. 


HoH POR HOW fi 


000113 


= 000144 
© 000144 


000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000027 
000037 
000244K 
000000 
000000 
000000 
000036 
000001 
000432R 
000062K 
000033R 
000124 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
O0O230K 
000604RK 
000001 
000041 
000034 
000022 
000236R 
000033 
O0O1L44R 


KUMP sTUMP / SF tly LIEXEMC/MLy C11» LOIRSXMC/FAS Le 07% 377 UMP 


Example 16-190 


Listing of Task TT2 
(Sheet 5 of 5) 


PRMT OOOQOOR 
PSeReeRe= 000063 
F€$CTlL= 000000 
FPE$FRS= 000310 
F&é$GMX= 000000 
PHIL = OO3100 
Fé$LAS= QO00000 
FS$lLOL= 001130 
P&éOFF= 000000 
FS$P4S= OO0000 
PERE L= 000000 
P¢$RTY= 000000 
FPé$SRF= 000000 
Q$sO0FT= 000005 
RS$$HER= 000000 
R#€$EXV= 000000 
R$$JS1= 000001 
R$$K1il= O0O0001 
R$$LKL= QOOOO0OL 
R$$lii= Oooodo!1 
R$$MOF= 000000 
R#¢$M11= 000001 
R$@¢N0C= 000005 
R#$NDIH= 000226 
R##NI= OOO001 
R$$FOLT= 000000 
RéS$SNI= OOOO000 
R$$1LiM= 000000 
R$$60F= 000000 
R¢$611= 000001 
S$$ECC= 000000 
S$$NM1= O51522 
S$$NM2= 030530 
S#ENM3= 046461 
S#$TIM= 000000 
S$$TOF= 000000 
S$$WLK= 000000 
S$$WFC= 000036 
Sé$$WFR= 000005 
S$$YSZ= 022000 
TERM 000250R 
TS#F$ACK= 000000 
(DUMP) 


TEEETWE 
TES EUPF = 
TES$CCA= 
TE$CCO= 
TS$CPW= 
TE$CTR= 
TESCUR= 
T#$C1 i= 
TE$ESC= 
TS$GMC= 
TS$GTS= 
TSSHFF = 
TS$HLO= 
TE$ILG6= 
TS#$KMG= 
TS$LWC= 
TE$RELlt= 
TSE$RNE= 
TESRFR= 
TE#$RST= 
TSS$RUB= 
TS$SMC= 
TS$SYN= 
TES TRW= 
TS$UT R= 
TSS$UTO= 
TS$US8= 
TESVEP = 
THE$3OR= 
UCE 

US$MHI= 
USSMLO= 
US $MRN&= 
VESCTR= 
V$$RSN= 
X$$ UR T= 
$ALOCEH= 
$COTER = 
$UEACK= 
$KEVHIbs 
$QNCRL= 
$$$ARG= 


000000 
000000 
000000 
000000 
000000 
000000 
000000 
000001 
000000 
000000 
000000 
000000 
000000 
000001 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000170 
000001 
000000 
000000 
000240R 
000000 
160000 
170234 
000400 
000040 
000000 
YORK KK 
KKK KK 
*KAK KK 
KAKKKK 
KKKKKK 
000002 


SHHSVYO WALSAS 


T8C 


QUMF . TSK Memory allocation mar TRE M39.70I 
1-NOV-81 11209 


Fartition mame ¢ GEN 
Identification + M4.0 
Task UTC 1 E7377) 

Stack limits? 120172 1231171 001000 00512. 

FRG xfr address? 121442 

Task attributes: PR 

Total address windows? 1. 

Task i imeste size : 800. words 

Yask address limits? 120000 123007 

kKeW disk blk limits? 000002 000005 000004 00004. 


KEK Root segment: DUMF 


R/W mem limits? 120000 123007 003010 01544. 
Ytiisk blk limits? 000002 000005 000004 00004. 
Memory allocation synorsis? 


Section 


Ao ee sree sone eee eure sone comm 


© BLN. 2 CRWe Ty LCL se REL eCON)D 121172 001504 00836. 
121172 001410 00776. 
$SREGLS CROry Te LCL yx REL » COND 122476 000112 00074. 


Global symbols? 


CO,RVE 010400 IO.WVR 011000 $ALOCKR 011346 


K¥KX Task huilder statistics? 


Totel work file references? 850. 

Work file readsi oO. 

Work file writes? 0. 

Size af core rool? 20506. words (80. rages) 
Size of work file? 768. words (3. Frases?) 


Elarsed timetd00300304 


Fade 1 


Title 


TUMF 


$NEACK 


Ident 


sone anes onse save coe 


011614 


Example 18-11 Map of Task TT2 


File 


ote wee eran oeee 


HUMP .OBRJs2 


$0EVHIt 


O10046 


$QNCRL. 


021432 


SdHSWYO WHLSAS 


SYSTEM CRASHES 


RSX-11M CRASH TUMF ANALYZER V4.0 1-NOV-81 11339 FAGE 9 
TASK DUMF 


TASK DUMP OF TT2 


tee ater ater nent man Orne ones Gene eens nee mene nH6e pod Geet Hees Stee Hoe mute Home 


TCR ADURESS = 0544406 HEADER ANDRESS = OS4554 


WINDOW BLOCKS: 


FAR VIRT LIMITS ATT DESC WNI SIZE OFFSET 1ST FIR ee LAST FOR 


GEN 120000 123077 047074 000031 000000 177612 1 014006 


eENnOY ioe ~~ TASK wen Tuer. a adioleg PEO eO nese ee 


ease eA eid TG. ppeRes: = 00440400 


1200006 000000 000172 053254 135400 ! CR M4. O !! & #V 35! 
L20010 OO3777 003777 170017 121442 'AKG AKG SFO ZDOB!! a a 
120020 121172 000000 000000 600000 1Y94 Piz" ! 
120030 000000 000000 000000 9000000 ! 1! ' 
120040 000000 600000 054702 000000 ! NNR H! RY ! 
120050 0009000 9000000 000000 000000 ! i] ! 
120060 000000 000000 000000 000000 ! tt I 
120070 000000) 054744 000006 046156 ! NOL F LIN! ! daY vL! 
120100 000000 046166 000000 046166 ! LIN LIN! ! vl vb! 
120116 000000 044166 000000 046072 ! LIN LG4!! vik Sh! 
120120 000000 046116 000000 600001 ! LHN Ati NL ! 
120130 115274 120000 123077 000000 IXOL YX ZW9 Pls Pe oO! 
120140 000031 000000 000612 014006 eS T4 C30!! ! 
120150 004070 000001 000000 1354600 'ALX A oO 118 3! 
120160 053254 000000 100100 000000 M4, TT2 IlyVo @ ! 
120176 000000 000000 0600000 000000 ! It ! 
CABOVE LINE REPEATED 60. TIMES 
121140 000000 006003 010400 000005 ! ASS B.2 el? ' 
121150 000001 900000 000000 054104 A NOS! ! Dx! 
121160 6000120 000000 000000 000000 ae PIP ! 
121170 000000 006412 047105 042524 ! BCR LT? KC.!! ENTE! 
121200 020122 020101 642524 0446522 'EF4 EFQ KC. LN4!!R A TERM! 
121210 047111 046101 047040 046525 'LUA LHA LT LN?!!'INAL NUM! 
121220 042502 035122 042440 052116 'KCJ IMJ KBP MSV!I'IBER? ENT! 
121230 051105 040440 041440 046517 IMFU JP2 J/7X LNI!!IER A COM! 
121240 040515 042116 043040 051117 1JQ? J7F KH2 MF1!! MAND FOR! 
121250 046440 051103 052516 041115 ILMX MFS MY8 JXM!! MCRNUMB! 


Example 18-12 CDA of Task TT2 
(Sheet 1] of 4) 


283 


SYSTEM CRASHES 


RSX-11M CRASH DUMF ANALYZER 


TASK TUMF 


121260 
121270 
121300 
121310 
L21320 
121330 
L21340 
121350 
121360 
121370 
121400 
121410 
121420 
121430 
121440 
121450 
121440 
121470 
121500 
121510 
121520 
121530 
121540 
1212350 
121540 
121570 
121600 
121410 
121420 
1214630 
121440 
121450 
121660 
121470 
121700 
121710 
121720 
121730 
121740 
121750 
12176 

121770 
122000 
122010 
122020 
122030 
122040 


O51105 044440 
020124 041517 
052040 054522 
O47111 O52041 
040516 020114 
047506 047125 
050040 047517 
044501 040514 
O27511 0270117 
O20122 047117 
040515 042116 
052125 000063 
000000 052124 
054100 044336 
000021 005046 
012744 000040 
012746 121172 
005044 112716 
000005 012746 
006003 104377 
065046 005044 
012746 121412 
121414 005046 
012746 000005 
612746 006003 
177424 012700 
0047467 001004 
000157 000434 
012700 010046 
0246760 1775466 
116067 000006 
000007 1775464 
003361 0100467 
000001 177530 
177522 001402 
016700 177520 
010104 166704 
000010 070504 
177470 012767 
104374 122000 
004767 067362 
177432 010067 
OOS767 177420 
000406 012700 
177406 012721 
016767 177374 
000004 177362 
005046 012744 
000027 012744 
005046 005046 
012746 000005 
012746 006003 
177274 005067 
005046 005046 
000120 016744 
O16744 177242 

Example 


V4.0 


20123 
040524 
040440 
051105 
O47516 
020504 
020114 
046102 
051105 
041440 
044440 
000000 
000000 
044212 
005046 
012746 
005046 
000001 
011000 
005044 
012746 
005046 
112716 
012746 
104377 
121412 
005702 
104374 
011000 
000004 
177570 
020167 
177546 
000207 
000187 
014002 
177510 
060502 
177777 
012701 
103404 
177432 
001402 
000124 
000040 
177370 
005046 
000040 
121225 
112716 
012746 
104377 
177272 
005046 
177260 
005046 


18-12 


1-NOV~S1 11:39 
047514 IMFU Ke. EFS 
026114 IEFS JOL JRO 
040507 IMRE NKZ JF 
044515 ILUA MRQ MFU 
020124 1JQ8 EF. LV 
047516 IL$N LUM EL6 
053101 1.22 LOW EF. 
020505 1K.3 JQ6 LHE 
047522 1GVY EFL MFU 
046517 1EF4 LUG J/X 
050116 1 JQ? JF K. 
000000 IMS/ AK 
054104 ! MS. 
000002 IND2 KZN KXJ 
005046 ! Q AX8 AX8 
000033 ICTF 2 CTF 
005046 ICTF Y?4 AXB8 
012746 1AXx8 WSO A 
012746 ' E CTF BSH 
0050446 1A65 US1 AX8 
000004 1AX8 AX8 CTF 
012746 ICTF ZCR AX8 
000001 1ZCY AX8 WEO 
010400 'CTF FE CTF 
0146703 ICTF AéS Ud1 
005002 ! 5O CSH ZCR 
001402 (AW LS ASJ 
121475 1 RS GF U60 
001422 {CSH BWN BSH 
001372 IGN 48 
114067 1X94 FOS 
177540 ! G 46 EGL 
062767 1ATIQ BW1 4 
005787 ! A 4H CO 
000430 ! 4h SJ Rg 
000002 InOF 4 LSJ 
014005 IRXD 8A. 32 
010267 ! H ROS OVR 
177454 1 3F CTW 80 
000124 1U60 ZIX CSI 
005247 IAWL QOR UXD 
000207 1 27 BW1i 22 
000147 1A6W PF SU 
014701 ! FY CSH ED 
077003 1 OF CSY 2 
062767 Inti 14 12 
005044 ! 0 1iZ AX8 
012746 1AX8 CTF 2 
005046 ! wWecrr zu 
000001 1AXB8 AX8 WBO 
011000 ICTF EE CTF 
005067 ICTF A&éS Ud1 
005046 ' OL. AYO OJ 
0127465 1AXB AXB AXB 
005046 | KR TIN Oo 
112714 INiN /Z AX8B 
CDA of Task TT2 


(Sheet 2 of 4) 


284 


FAGE 10 


L$VIlER IS NO! 
GCT!!T OCTALs! 
JQ1!! TRY AGA! 
K/E!! IN! TERMI! 
EF6!!NAL NOT ! 
LéV! 1 FOUNDING! 
M2A!! FOOL AV! 
EL7!!ATLABLE! ! 
L$Z!!I/0 ERRO! 
LNA!!R ON COM! 
L3S!!MAND INF! 
1!uT3 ! 
N6!! TT IX! 
BIt@X"H H |! 


' 
1 

Z 1 
CTF! N f i! 
CTFilt Ff f i! 
AXSi! & & ! 
Wile & Ff ! 
CTFilf #& fF ! 
All ! 
BR.2'tf f \ 
nhoseir Cc! 
AXE! ! ! 
SJblw Kk 1 
ZG8!tw “os $! 
SZ!'@ & | 
SEllpe-y ! 
X9LE17 | 
42i'oot ! 
FLUE la 7 ! 
A6W!II' xX w i! 
' 

{ 

{ 

{ 

\ 

{ 

1 

! 

i 

1 

i 

\ 

{ 

' 

i 

1 

1 

{ 

i 

1 

1 

{ 


is) 
+ 


GNM 


G tlk wW 
R'!@ F 
SM! tn DmH 
B29!!! Tlebse? 
30!'8 w , 
Rott” $A T 
AWl!iuorn 7 
COll 7 
BO! Iw Ww 
nogt! @ TA 
TFSEI 
PLW I tw 
AXS!! 
CTFIIa f ft 
AXS8!tt ff "% 
A'I& & N 
RSH! If f 
AYO! Ff 
AXBl lav? 3 
CTFEIS & & 
AXStLIF fF O”% 
WBO!!f 


RSX-11M CRASH 


TASK [DUMP 


1221606 
122170 
122200 
122210 
122220 
122230 
122240 
122250 
122266 
122270 
122300 
122310 
122320 
122330 
L22340 
122350 
122340 
122370 
122400 
122410 
122420 
1224306 
122440 
122450 
122440 
122470 
122500 
122510 
122520 
122530 
122540 
122550 
1223560 
1225706 
122696 
122610 
122620 
122430 
122640 
122450 
122460 
122670 
122706 
122710 
122720 
122730 
122740 
122750 
122760 
122770 
123006 
12301060 
123020 
123030 
123640 
123050 


SYSTEM CRASHES 


DUMP ANALYZER 


QO0001 012746 
010400 012746 
103002 000167 
177204 002002 
104374 122244 
016761 177176 
077170 900207 
104377 005046 
012744 000040 
012746 121254 
005046 112716 
000005 012744 
0046003 104377 
005020 077302 
0050446 005046 
060040 0123746 
121313 005046 
112714 000001 
012746 011000 
104377 0127464 
005046 005044 
000040 012746 
121334 005046 
112716 000001 
012744 011000 
104377 012746 
005046 005044 
000040 012746 
121360 005046 
112714 000001 
012746 0611000 
104377 104376 
176644 012701 
047022 000207 
104377 012702 
012702 600010 
005001 112005 
001774 122705 
162705 000060 
010004 010200 
010400 0460501 
116002 177777 
012746 000021 
0046001 103002 
005316 003371 
000020 010144 
OO4101 020116 
OOS200 005366 
022626 000207 
010544 016605 
012603 012604 
000000 000000 
000000 000000 
000000 000000 
000000 000000 
000000 000000 

Example 


V4.0 


000005 
006003 
000272 
000167 
016701 
000002 
012746 
005045 
012746 
005046 
000001 
011000 
012700 
000167 
005046 
000023 
005046 
012746 
012746 
000443 
005046 
000022 
005046 
012746 
012746 
000463 
005046 
000032 
005046 
012746 
0127465 
122574 
000124 
012746 
000012 
004567 
122705 
000011 
120502 
004767 
112005 
000207 
005000 
066600 
000415 
005001 
103402 
000002 
010446 
000006 
012605 
000000 
000000 
000000 
000000 
000000 


18-12 
(Sheet 


1-NOV-81 
012744 1 oA 
104377 IRe2 
105767 1UQZ 
000260 1 46 
177200 1Ud0 
004767 nay 
0004463 ITIF 
005044 1Ud1 
000037 ICTF 
005046 'CTF 
012746 !AX8 
012746 Dt 
121412 1AGS 
177102 1AXF 
012746 'AX8 
012746 i ie 
005046 'ZAS 
000005 'WEO 
006003 'CTF 
104377 1U61 
012746 1AX8 
012746 Po 2 
005046 1ZBN 
000005 1W8O 
006003 ICTF 
104377 161 
012746 'AX8 
012746 t 2 
005044 'ZR2 
000005 !W8o0 
006003 'CTF 
016700 'U61 
004767 1 WN 
000463 !QXR 
000402 1U61 
000144 iCSJ 
000040 1AXA 
001771 t YT 
103010 '40U 
000016 IBYVT 
000764 IB. 
010046 IX8R 
006000 iCTE 
000002 1Ab&S 
012746 tA/F 


004300 YF 
161601 hASQ 
003367 !ASH 
610346 'F Y 
004734 'RIN 
000207 'CQS$ 
000000 i 
000000 ! 
000000 ! 
000000 ! 
000000 ! 


CDA of Task 
3 of 4) 


285 


11239 FAGE 11 
CTF E-CTEE) sf f 
CTF AéS5 USl!! Ff 

RP OZ VOi!! wiw 
YZ EKO DR!! *~ wo 
ZM- DOQ .2!!" $$ * 


Ué61 CSH ZCR!! C@ # 
TKI BY $J5JI! BYw RY 
AXB AX8 CTF!I'R & & Ff 
CTF S CTF!! f f 
AX8 AX8 AXS!IIK"S & & 
A CTF E!IN F 
RSH CTF A6éjS!I!If f 
CTF Gt Ud6i!! fF 3 
AX8 AX8 CTF!!% & & f 
CTF R CTF?! Ff f 
AX8 AXB AXB!II™"S & & 
A CTF E'!tn f 
BSH CTF AéS!!f f 
CTF Gt Ud6i!! Ff 3 
AXE AXS8 CTF!!'& & 2 f 
CTF Z CYF!! Ff ft 
AXB AXB AXB!te"& & & 
A CTF E'IN f 
BSH CTF A6éS!!Ff f 
U60 ZS0 TOF!!! ~ i4e@ 
CSI BO AW1!!&3A T w 
CO CTF GEé!! mn Ff 3 


CQ. CQ/ CO! 


ee oe eS 


TT 2 


SYSTEM CRASHES 


RSX-11M CRASH DUMF ANALYZER V4.0 1-NOV~-81 11239 FAGE 12 
TASK [UMF 


123060 000000 000000 000000 000000 ! r! 
123070 000000 000000 000000 000000 ! rt 


CENT OF ANALYSIS OUTFUTI 


Example 19-12 CDA of Task TT2 
(Sheet 4 of 4) 
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DIRECTIVE PROCESSING 


INTRODUCTION 


Many tasks require activities, such as I/0, which cannot be 
eaSily performed within a user task. To provide the facilities 
for these activities without requiring privileged tasks and 
extensive knowledge of the inner workings of the operating system, 
RSX-11M provides a set of system services called Executive 
directives. 


Executive directives provide a simple interface to these 


services. This interface is through system macros’ for’ the 
MACRO-11 programmer and system subroutines for’ the FORTRAN 
programmer. The interface also provides a completion code for 


error checking. 


OBJECTIVES 


1. List the steps in processing an Executive directive. 


2. Perform the steps necessary to add a user written directive to 
the system. 


RESOURCES 


1. RSX-11M System Lists and Data Structures 


2. RSX-l11M/M-PLUS Executive Reference Manual 
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THE USER TASK INTERFACE 


e MACRO-11 task uses macros to invoke directives 
e Three types of macros 
$-form 
$C-form 
$S-form 
e FORTRAN tasks call subroutines 
e Directive Parameter Block (DPB) used to pass data to system 
e Result of directive execution indicated by 
Directive Status Word (DSW) 
Processor Status Word 
Set to indicate failure 
Clear to indicate success 
Directive Parameter Block 
e Data structure contained within the user task 
e Contains parameters needed to execute the directive 
Directive identification code (DIC) 
Other parameters as needed 
Length depends on DIC, can be variable 
@ Location of DPB 
In task data area 
In user selected PSECT 
In PSECT SDPBSS$ 


On task stack 


e Directive identification code always odd whole number 
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TASK 
HEADER 
Sa ee 
TASK 
SP "aor SS OF OPS even VALUE) 1) STACK 
DATA AREA 
BLANK 
PSECT 
CODE 


$DPB$$ 
PSECT 


Figure ll-1 Directive Macros: '$' Form 


TASK 
HEADER 


TASK 
STACK 


DATA AREA 


Figure ll-1 Directive Macros: 'S$S' Form 
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TASK 
HEADER 


TASK 


sp STACK 


DATA AREA 


CODE 


[DPB FOR DIRECTIVE] 


Figure 11-1 Directive Macros: ‘'S$C‘' Form 


$DPB$$ 
PSECT 
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'S' FORM 
SEND: SDATS TASKB,BUF,5 SEND: ~BYTE Tle 
-RAD5@ /TASKB/ 
.WORD BUF 
-WORD 5 
DIRS #SEND,ERR MOV #SEND,-(SP) 
EMT 377 
BCC .+6 
JSR PC,ERR 
'SC' FORM 
-PSECT SDPBSS 
$$$ = 7 
~BYTE Tliats 5 
-RADS5@ /TASKB/ 
SDATSC TASKB, BUF,5,PROG1,ERR . WORD BUF 
| ~WORD 5 
-PSECT PROGI 
MOV #$$$,-(SP) 
EMT 377 
BCC +6 
JSR PC, ERR 
'S$S' FORM 
TASKB: .RADS@ /TASKB/ TASKB: -RAD5@ /TASKB/ 
MOV #5,-(SP) 
MOV #BUF,-(SP) 
MOV TASKB+2,-(SP) 
SDATSS #TASKB,#BUF,#5,ERR MOV TASKB,-(SP) 
MOV (PC) +,-(SP) 
- BYTE Tle7> 
EMT 377 
BCC +6 
JSR PC,ERR 


Example 11-1 Macro Expansions for SEND DATA 
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DPB SIZE | 

IN WORDS 
PARAMETER 1 
PARAMETER 2 


PARAMETER N 


Figure 11-2 The Directive Parameter Block 
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Directive Status Word 
e Executive returns a status code in the DSW 
e In general, success is denoted by a status of +1 
e The Set/Clear Event Flag directives use 
@ to indicate success and flag clear 


2 to indicate success and flag set 


e An error is indicated by a negative status 


e Value stored at location $DSW in the task header 
(in task region) 


e In FORTRAN, value returned in calling argument 
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THE DIRECTIVE DISPATCHER 


The 


EMT trap causes entry to module DRSUB at $EMTRP 


Module DRDSP is mapped uSing KERNEL APR5 and control passes to 
module DRDSP at $DRDSP 


Routine $DRDSP distinguishs between directive calls, calls to 
SSWSTK and non-RSX EMT traps 


For directive calls 
KERNEL APR6 is used to map 


WDB or RDB if PLAS directive 
DPB otherwise 


Directive processing routine is called 


To process a request to switch to kernel mode, a jump to. the 
Executive routine SSWSTK is executed 


For non-RSX EMT traps, a jump to SEMSST in SSTSR is executed 


Directive Dispatch Table 
Contains entry for each directive 

Address of service routine 

"Flags byte' 

Length in words (For variable length = Q) 
Assembled in one of two possible forms 

Single table form 

Two words per possible directive 


Double table form 


One byte per possible directive 
Two words per existing directive 


The form which uses the least space is automatically chosen 


If less than 75 percent of directives exist, use the two 
table structure 


If 75 percent or more of the possible directives exist, 
use the one table structure 
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alio$ 1. 3: 
4. 

aiow$ 3. 6. 
8. 

GLUN$ 5. ADDRESS OF $DRGLI 10. 
12. 

ALUNS$ 7. 14. 
16. 

ALTP$ 9{ sir OD Siz 
ee ae a ee eo 

RQST$ 11. 22. 
24. 

UNUSED 13., = cli ( ststi(‘iélilésl:C€éC~W 
OO) 28: 

UNUSED 18: [| C8. 
Pee OO eet OP tp. tes 

RUN$ 17. 34. 
36. 

UNUSED 19. 40. 
42. 

SRRA$ 21. a 
MRKT$ 23. 50. 
52. 

Single Table Form 
TABLE 1 TABLE 2 


ADDRESS OF $DRQIO 
FLAGS BYTE DPB LENGTH=12. 


FLAGS BYTE DPB LENGTH=4. 
ADDRESS OF $DRREQ 


FLAGS BYTE DPB LENGTH=7. 


FLAGS BYTE DPB LENGTH=2. 
ADDRESS OF $DRMKT 
FLAGS BYTE DPB LENGTH=S5. 


Double Table Form 


Figure 11-3 The Directive Dispatch Table 
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SOROSP 


ADDRESS CHECK 


RDB/WDB NO 


CONVERT 
EVENT FLAG 


—6-— $< — CALL ROUTINE 


Figure 11-4 Processing in DRDSP 
(Sheet 1 of 2) 


EFN 
REQUIRE 


ERROR 


0? 
NO 
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YES 


YES RO=TCB 
ADORESS OF 


NO DEFAULT 
TO CURRENT 


TASK? 


MORE 


PRO SING? 
one CURRENT TASK 


NO 


TASK 
SPECIFIED? 


eS YES 


CALL 
$SRSTD 
NO 


YES 


TASK NAME 
FOUND? 


MULTI-USER 
PROTECTION? 


YES 
@ 


NO 
ERROR 


NO 


Ris TASK 
STATUS WORD 


CALL ROUTINE 


Figure 11-4 Processing in DRDSP 
(Sheet 2 of 2) 
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ERROR 


DIRECTIVE PROCESSING 


DIRECTIVE PROCESSING ROUTINES 


The Interface 


Directive processing routine is called with registers loaded 
as in Table 11-1 


Flag byte in directive dispatch table determines processing 


ACHKDB 


CEFNCL 


GEFUSE 


CEFNMT 


DFCTSK 


MUPCHK 


SRSTCL 


Address PLAS definition block 

Convert the event flag 

Do not increment group global use count 
Event flag must be specified 

Task name defaults to current task 
Perform multi-user protection check 


Call $SRSTD to find TCB in STD 


Bits set in flag byte determine contents of R@ and Rl 


If CEFNCL 
RQ - 
Rl - 


If SRSTCL 
RQ - 
Rl - 


specified 
Event flag mask word 
Address of event flag 


specified 


TCB address of specified task 
Address of status word in TCB 
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Register 
R5 
-R4 
R3 


R2 


Rl] 


RO 


DIRECTIVE PROCESSING 


Table ll- 


Contents 
Address 
Address 
Address 


Address 


1 


of 


of 


of 


of 


Register Usage 


the TCB of the current task 
the header of the current task 
the next word in the DPB 


the second task status word of 


the current task 


- Depends on directive 


‘Depends on directive. 
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The Directive Commons 


e Most directive processing code removed from Executive 


Increases available DSR 


@e Two directive commons, EXCOM1 and EXCOM2 
Existence of commons determined at SYSGEN 
Kernel I-space APR 5 used to map directive commons 
Location of processing routine indicated by low order 
of address of routine in DDT 
e Module DRSUB 
Is in the Executive 
Always mapped 
Contains the location SEMTRP 
Calls SDIRSV 
Maps to DRDSP which is in EXCOM1 


Contains coroutines SMPXC1 and SMPXC2 which are 
used to map EXCOM1 and EXCOM2 
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DIRECTIVE PROCESSING 


1/0 PAGE 


USER TASK 


KERNEL ACTIVE 
PAGE REGISTERS 


APR#4 EXCOM2 
APR#2 EXCOM1 


EXECUTIVE 


EXECUTIVE MAPPING 


Figure 11-5 The Directive Commons: Standard Executive Mapping 


DIRECTIVE PROCESSING 


1/0 PAGE 


KERNEL ACTIVE 
PAGE REGISTERS 


APR#7 


APR#6 


APR#4 EXCOM2 
APR#2 EXCOM1 


APR#0 
EXECUTIVE 


Figure 11-5 The Directive Commons: Mapping to Reference EXCOM1 
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Module 


DRABO 
DRASG 
DRATP 
DRATX 
DRCIN 
DRCLI 
DRCMT 
DRDAR 
DRDCP 
DRDSP 
DREIF 
DREXP 
DRGCL 
DRGEF 
DRGLI 
DRGPP 
DRGSS 
DRGTK 
DRGTP 
DRMAP 


DRMKT 
DRPUT 
DRQIO 
DRRAS 
DRREG 
DRRES 
DRSED 


DRSMG 
DRSPW 
DRSST 
DRSUB 


Table 11-2 


Location 


EXCOM1 
EXCOM2 
EXCOM2 
EXCOM1 
EXCOM2 
EXCOM1L 
EXCOM1 
EXCOM1 
EXEC 

EXCOM1] 
EXEC 

EXCOM2 
EXCOM1] 
EXCOM2 
EXCOM1 
EXCOMI 
EXCOM1 
EXCOM1 
EXCOM2 
EXCOM2 


EXCOM] 
EXCOM] 
EXCOM1 
EXCOM1 
EXCOM2 
EXCOM1 
EXCOM1 


EXCOM2 
EXCOM1 
EXCOM] 
EXEC 
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Directive Processing Modules 


Routines 


SDRABO 
SDRATX 


SDRCIN, 
SDRCLI, 


SDRDAR, 
SDRDCP, 
STRTRP, 
SDREIF, 
SDREXP 
SGRGCL, 
SDRCRE, 
SDRGLI 
SDRGPP 
SDRGSS 
SDRGTK 
SDRGTP 
SDRCRW, 
$DRGMX 
SDRMKT, 
SDRREX, 
SDROIO 
SDRRCS, 


SDRUNS, 
SDRCEF, 
SDRWES 


SDRSDV, 
SELGEF, 
SMPXCl, 
SGTUCB, 
SDRATP 


SDISIN 
SSTCLi; 


SDREAR 
SDRECP 
SDRTRP, 
SDREXT, 


SRLMCB, 
SDRELE, 


SDRELW, 


SDRRUN 
SCAAST, 


SDRREC, 


SDRRES, 
SDRRAF, 


SDRSTV 

SDEAGF, 
SMPXC2, 
SSTCLI, 
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SSTCLI 


SEMTRP, 
SDREX1 


SRLCIB 
SUNLCK, 


SDRMAP, 


SDRFEX, 


SDRSND 


SDRSEF, 


SSRGEF, 
SDETRG, 
SFNCLI, 


SDRDSP, 


SGTGEF 


SDRUNM, 


SDRPUT, 


SDRSPN 
SDRSTS, 


SDRDSE, 
SCITFR, 
STRTRP, 


SDRATP 


SDRSRF, 


SDRRRA, 


SDRSTL, 


STKWSE, 
SDRORQ, 
SEMTRP, 


SDRRRF 


SDRRCV 


SDRWFL 


SDRWSE 
SSRCCOQ 
SOTHRI] 


DIRECTIVE PROCESSING 


Send/Receive Processing 
e Used to transfer a 13-word data packet to a specified task 
e Routine SDRSND in module DRRAS used to send data 
e Routine SDRREC in module DRRAS used to receive data 
e Steps in sending/receiving 
An 18-word send/receive data block is allocated in DSR 
Link word for receive queue 
Sender name in RAD5@ 
13-word data area 
UCB of TI: of sender 
Current UIC of sender 


A 13-word buffer in sender task is copied into DSR block 


A 15-word buffer in user task receives sender name _ and 


data 


15 WORD acta 
SEND/RECEIVE 
— td 
TASK A 


13 WORD 
BUFFER 


Figure 11-6 Send/Receive Processing: Send from TASK A 


307 


DIRECTIVE PROCESSING 


TCB 


SEND/RECEIVE 
DATA BLOCK 


18 WORDS 


Figure 11-6 Send/Receive Processing: 


388 


TASK B 
15 WORD 
TASK A 


13 WORD 
BUFFER 


Receive by TASK B 


DIRECTIVE PROCESSING 


Parent/Offspring Tasking 
e Connecting TASKA to TASKB 
TASKB passes a one-word status back to TASKA when 


TASKB exits 
TASKB emits status 


TASKA is the parent task, TASKB is the offspring task 


e TASKA spawns TASKB 
TASKA requests TASKB 


TASKA connects to TASKB 


e Steps in connecting 
A 14-word offspring control block is allocated in DSR 
OCB is linked to the TCB of the offspring task at T.OCBH 


When offspring exits or emits status, status moved to OCB 
placed into first word in 8-word status area 


Status automatically moved into parent status buffer 


Parent task specifies event flag and/or AST for 
notification of the offspring's return of status 
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14 O.STAT 


EXIT STATUS 
BUFFER 
(8 WORDS) 


Figure 11-7 Parent/Offspring Tasking: Offspring Control Block 
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TCB OF 
PARENT TASK 


T.ROCT=1 


TCB OF 
OFFSPRING 
TASK 


TCB OF 
CONNECTING 
TASK 


T.ROCT=0 


Figure 11-7 Parent/Offspring Tasking: Spawning a Task 
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TCB OF 
PARENT TASK 


T.ROCT=1 


TCB OF 
OFFSPRING 


TASK 


T.OCBH 


TCB OF 
CONNECTING 
TASK 


T.ROCT=1 


Figure 11-7 


DIRECTIVE PROCESSING 


O.LNK 
a 
O.PTCB 


Parent/Offspring Tasking: 


32 


O.LNK=0 
nates 
O.PTCB 


Connecting to. a Task 


DIRECTIVE PROCESSING 


Memory Management Processing 


User task specifies information for creating/attaching to a 
region in a Region Definition Block (RDB) 


Information in RDB used to initialize PCB for subpartition in 
dynamic partition 


User task specifies information for creating/mapping an 
addressing window in a Window Definition Block (WDB) 


Information in WDB used to initialize window block in task 
header 
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REGION DEFINITION PARTITION CONTROL 
BLOCK BLOCK (PCB) 


LINK TO NEXT PARTITION PCB 
1/0 COUNT=0 PRIORITY OF PARTITION 
SIZE OF REGION PARTITION NAME 
(32W BLOCKS) (IN RADIX-50) 
NAME OF REGION 


POINTER TO NEXT SUB-PARTITION 
(RADSO) 


POINTER TO MAIN 
PHYSICAL START ADDRESS OF PARTITION 
SIZE OF PARTITION 


PARTITION WAIT QUEUE LIST HEAD 
PARTITION SWAP SIZE (SYSTEM ONLY) 


REGION STATUS WORD 
PROTECTION WORD FOR REGION 
ATTACHMENT DESCRIPTOR 
REGION PROTECTION WORD 
LIST HEAD 


CREATING A REGION 


REGION'S MAIN PARTITION NAME 
(RAOSO) 


WINDOW DEFINITION 
BLOCK 


VIRTUAL BASE ADORESS (BYTES) 
WINDOW SIZE (32W BLOCKS) \ 


TASK ADDRESSING 
WINDOW BLOCK 


PCB ADDRESS 
LOW VIRTUAL ADDRESS LiMIT 
HIGH VIRTUAL ADORESS LIMIT 
ADDRESS OF ATTACHMENT DESCRIPTOR 
SIZE OF WINDOW IN 32. WORD BLOCKS 
PHYSICAL MEMORY OFFSET IN 32. WORD BLOCKS 
NUMBER OF FIRST POR ADDRESS 
APRS TO MAP (LOW BYTE) 
CONTENTS OF LAST POR 


CREATING AND MAPPING A WINDOW 


Figure 11-8 Memory Management Processing 
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ADDING A USER-WRITTEN DIRECTIVE 


e Interface to the directive processing 
Structure of Directive Parameter Block must be determined 
Entry for new directive must be added to the DDT 
Directive processing routine must be written 
Macros to invoke directive must be written 
Directive processing routine must be built into the system 


Macros must be added to the system macro library 


Structuring the Directive Parameter Block 
e Information needed to execute directive 
e Choose an unused DIC 
e Choose order for necessary parameters 


If event flag is first parameter, specify CEFNCL and/or 
CEFNMT 


If task name is first parameter, specify DFCTSK and/or 
SRSTCL 


DIC=161 


TASK NAME 


IN RAD5O 


EVENT FLAG NUMBER 


Figure 11-9 Directive Parameter Block for New Directive 


315 


DIRECTIVE PROCESSING 


Changes to the Directive Dispatcher 
e DDT determines 
Which directive processing routine to call 
What processing to perform in DRDSP 
Size of DPB 
Where the module is to be located (directive commons) 
e Each directive is represented by a line in the DIREC macro 
defined in the module DRDSP 


e Format of line in DIREC macro is 


MAC DIC, DPBSIZ,DIRADR,MASK, COND, SECOND 


Where 

DIC - Directive Identification Code 

DPBSIZ - Size of the DPB 

DIRADR - Address of the Directive Processing Routine 

MASK - Directive Processing Control Mask 

COND - Conditional Assembly Parameters which must 
be defined if the directive is supported 

SECOND - Conditional assembly parameters which if 
defined require that the directive have a 
variable length DPB 

Example: 


MAC 55.,2-,SDRCRR! PAG, <ACHKDB>, PSSLAS 
This is the ‘create region' directive. 
PAG is set to 1 if directive common support is 


desired, @ otherwise. The service routine will be 
placed in EXCOM2. 
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Place the following in the Directive Dispatch Table 


MAC 161.,4.,SDRFLG! PAG, <DFCTSK! SRSTCL> 


DIC 

Size of DPB 

Processing Routine 
Force to EXCOM2 

Default to current task 
Call SSRSTD to find TCB 


Example 11-2 New Entry in the Directive Dispatch Table 
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The Directive Processing Routine and Macros 


e Routine should be written to make use of the standard register 
usage in DRDSP 


e Assembly with EXEMC and RSXMC 


e Provide only macros needed by applications 


*TITLE ORFLG 
+IQENT 71.07 


oof 
> xX ~ $0RFLG - SET TASK’S LOCAL EVENT FLAG 


THIS DIRECTIVE INSTRUCTS THE SYSTEM TO SET A SFECIFIED TASK’S LOCAL 
EVENT FLAG. 


eB FORMAT? 


Wht, OO -- DIC (161.)» DFR SIZE (4.) 
Wit. OL -- FIRST HALF OF TASK NAME CRADSO) 
WO. O2 ~- SECOND HALF OF TASK NAME (CRADISO) 
WO. O3 -- EVENT FLAG NUMBER (1-32.) 


SED MGR Se he er ER oe MER Ee SR Ee 


y INFUTS? 

? RO = TCR ADUR. QF TARGET TASK 

i Ri = ADUR. OF FIRST TASK STATUS WORD 
: R2 = ADUR. OF SECOND TASK STATUS WORT 
3 R3 = ADUR. OF NEXT WORD IN DFR 

? R4 = ADDR. OF HEATER OF CURRENT TASK 
: RS = ADR, OF TCR OF CURRENT TASK 


C = O IF DIRECTIVE IS SUCCESSFULLY COMPLETED 
QIRECTIVE STATUS 0U.RS22 IS RETURNED IF EVENT FLAG IS 
ALREADY SET 


$  QUTRUTS: 


: QLRECTIVE STATUS DO.RSOO IS RETURNED IF EVENT FLAG WAS 
e CLEARET 
oF C = 1 IF DIRECTIVE ITS REJECTED 
: NIRECTIVE STATUS U.RS97 ITS RETURNED IF ILLEGAL EVENT 
> FLAG 
*-ENARL LSE 
ORF LG S 3 
MOV ROVERS yANTIR OF TARGET TASK TCE 
CALL $CEFN SCONVERT TO EVENT FLAG MASK 
RCS 2O$ VTLLEGAL EVENT FLAG 
RIT ROvy¢R1) »sEVENT FLAG ALREADY SET? 
BEQ LOs gNOv ITF EQUAL 
ORSTS O.RS22 #RETURN STATUS 
LOS? BIS ROvCK1L) ¢ SET THE EVENT FLAG 
IRSTS QN.RSOO sRETURN STATUS 
OBS QRSTS D.RSY? ¢TLLEGAL EVENT FLAG STATUS 
«END 


Example 11-3 Processing Routine for New Directive 
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“Se NGY Re 


*MACKO 
«BYTE 
ROO $ 
«WORT 
+ENIM 


«MACRO 
ePSECT 
EH = 

+RYTE 
ROS 
+WORTD 
sPSECT 
MOV 
EMT 
«IF NE 
BCC 
JSR 
eENTIC 
oE NOM 


$+ 
; $$ FORM 
$~ 


*MACRO 
MOVE 
RF AS 
MOV 
*BYTE 
Eke 
oENTIM 


Example 11-4 


$ FORM OF 


p $C FORM OF MACRO FOR 


SLEF SC 
SUPRSS 


OF MACRO FOR 
SLEF ES 
EFN 
TN 


MACRO FOR #0RFLG 


SLEF& TNeEFN 
Lé1.°4 

TN 

ESPN 

SLEF $ 


$0RFLG 
TNryEFNe ERR e PST 


+ 


161.94 
TN 
EFN 


PST 


etd 


PCs ERR 


SLEF &C- 


$0RFLG 


TNeEFNYERR 


CPC +9-(SP) 


141494 


vERR 


SLEF SS 


Macros for New Directive 


319 


DIRECTIVE PROCESSING 


Adding a Directive to the System 
e Directive can be included in the Executive or in EXCOM2 
In the Executive if 
Directive commons not chosen at SYSGEN 


Not enough room in EXCOM2 
Otherwise in EXCOM2 


e To include in the Executive 


Build with the Executive during SYSGEN 


@e@ To include in EXCOM2 


Build with EXCOM2 during SYSGEN 


e Macros included in system macro library RSXMAC.SML 


328 


DIRECTIVE PROCESSING 


MAC DRFLG=LB: [1,1] EXEMC/ML,SY: [11,10] RSXMC,DRFLG 
LBR LB: [1,24] RSX11M/IN :DRFLG 
/ LB: [1,24] RSX 11M/LB:DRFLG 
| ‘ TKB @RSXBLD 


> 


ASSEMBLE 
DIRECTIVE 
ROUTINE 


ADD OBJECT 
| MODULE TO 
LIBRARY 


ADD LINE 
TO TASK BUILD 
COMMAND FILE 
TASK BUILD 


Figure 11-18 Assembling and Taskbuilding the Processing Routine 
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I/O PROCESSING 


INTRODUCTION 


Any modern operating system must provide a complete I/0 
system. Besides providing basic I/O device handling software, it 
must also provide a convenient file system. 

Device drivers handle primitive I/O functions under’ RSX-11M. 
These drivers are tailored to individual devices and optimized to 
provide maximum performance. They are invoked by means of the QIO 
mechanism. 

RSX-11M uses the FILES-11 file system. There are two levels 
of software support in the operating system for FILES-1l. The 
more visible level includes the file access systems, FCS, and RMS. 
These systems provide all features needed in any application under 


RSX-11M. A more primitive level, in the form of ACPs (FII1ACP), 
forms the interface between FCS/RMS and device drivers. 


OBJECTIVES 


1. Diagram the flow in the I/O system. 
2. List the types of ACPs and their differences. 


3. List the steps in processing an I/O request within DROQIO. 


RESOURCES 
1. RSX-11M System Lists and Data Structures 
2. RSX-11M Guide to Writing an I/O Driver 


3. RSX-11M/M-PLUS I/O Operations References Manual 
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OVERVIEW 


Components of the I/O System 
e The File System 
Used to structure data for convenient use in applications 
Provides software for easy manipulation of data 
Consists of: 
FILES-11 structures 
File Control Services (FCS) 


Record Management Services (RMS) 


e QIO directive 
Used to request I/O service from the Executive 
Can be used directly in user task 


All file-system I/O requests converted into QIOs 


e Device Drivers 
Used to control physical devices and perform actual I/0 
One required for each device type 


Carry I/O requests to transfer data 


327 
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Ancillary Control Processor (ACP) 
Performs functions subordinate to those of the driver 
Provides a file system for user tasks 


Handles protocols needed by a communications network 


Converts I/O requests into one or more request to a device 
driver 


Manipulates I/O parts of the system data base 
Three ACPs provided with RSX-11M 

FI1ACP: Files-1l 

MTAACP: Magtape I/O ACP 


NETACP: DECNET ACP 
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USER STATE 


SYSTEM STATE 


USER TASK 


@ 


CALL a 


NOTE: UQIO: USER ISSUED QIO @) 
AQIO: ACP ISSUED QIO [ 


Figure 12-1 The I/O Process 
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Initiating |/O From a User Task 

e Use QIO directives 
Harder to use than other methods 
Can be the most efficient method of I/0 
For file I/O, use virtual block transfers 


For non-file I/0, use logical block transfers 


e Use high-level language I/O commands 
Easier to use than QIOs, but less efficient 
Language processor may convert to QIOS or convert to 
FCS/RMS commands 

e Use FCS/RMS to perform file system I/0 


Allows data to be accessed in a form natural to the 
application 


File processor converts to QIOs 
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Processing |/O Request in DRQIO 


All I/O performed as a result of QIO directives 


QIO directive parameters are checked; directive status is 
returned 


Parameters used to create I/O packet 
I/O packet is queued to a device driver or to an ACP 


If ACP function, a number of checks are performed before 
queuing I/O packet 
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QIO PROCESSING 


Logical Units 


e Logical Unit Numbers (LUNs) identify the device to which I/0 
is to be performed 


e LUN determines a unique entry in the task's Logical Unit Table 
(LUT) in the task header 


e Each entry in the LUT is two words long 


e When a task is installed, the first word of each LUT entry is 
initialized with the UCB address of the device 


e When a file is opened on a volume, the second word of the 
corresponding LUN points to a FILES-11 window block 


TASK 
HEADER 


USER TASK 


QIO -,3.,... 


UCB ADDR. 
LUT¢ } ------ 


Figure 12-2 Logical Units 
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Processing Within DRQIO 


e Locates the UCB for LUN 


Calls SMPLUN in module EXESB 


e Checks to see if driver resident 


Location D.DSP in the DCB 


e Clears specified event flag 
e Clears I/O status block if specified 
e QI0O directive is now successful 

DSW shows success 


Any errors are reported as I/O errors in the IOSB 


e Allocates space for I/O packet in POOL 


Calls SALPKT in module CORAL 


e Increments I/O request count in the TCB 

e Copy data from DPB to I/O packet 

e If function is IO.KIL, go the routine SIOKIL in module IOSUB 
e Check if task has privileges to perform I/0 

e Check function code against function masks in DCB 

e If not legal function, return I/O error 

e If control function, queue I/O packet to driver 

e If 'no-op' function, return successful status 


e If ACP function to mounted device, perform ACP function checks 
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The ACP Function Checks 


Implemented by a collection of primitive routines 
Each ACP requires a different group of these routines 


A two-level dispatch table, the Polish Interpreter Database, 
is used 


First level table, the Function Code Dispatch Vector, resides 
at FCDSP in DRQIO 


Each entry corresponds to a unique function code 
Each entry is a vector which points to a_ second level 


dispatch table 


Second level dispatch table contains primitive routines to be 
called 
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Table 12-1 Function Code Dispatch Vector 


Function Dispatch 

Code Table Function 

1@ FCIFC Illegal function 

ll FCPKT Find file name in directory 

LZ UNLCK Unlock Block 

13 FCPKT Remove file name from directory 
14 FCPKT Enter file name in directory 

15 FCACC Access file for READ 

16 FCACC Access file for READ and WRITE 
17 FCACC Access file for READ, WRITE, and EXTEND 
26 FCDAC Deaccess file 

21 FCRVB Read Virtual Block 

22 FCWVB Write Virtual Block 

23 FCEXT Extend file 

24 FCCRE Create file 

25 FCDEL Mark file for DELETE/TRUNCATE file 
26 FCPKT Read file attributes 

ae FCPKT Write file attributes 

30 FCPKT User magtape control function 
31 FCWVB Transmit process message 

32 FCRVB Receive process message 

33 FCCON Connect to process 

34 FCDIS Disconnect from process 

he: FCNCT Network control process 

36 PCIPC Illegal function 

37 FCIFC Tllegal function 
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“Table 12-2 Polish Routines 


Table Routine Function 
FCIFC IEIFC Set illegal function status 
FCACC CKDMO Check if volume marked for dismount 
CKALN Check if file already accessed on LUN 
CKMOU Check volume mounted this user 
CKACP Set flag to queue to ACP 
BDPKT Build an I/O packet 
CKRLK .. Synchronize access and exit 
FCDAC CKNLN ~ Check if file accessed on LUN 
CKQMT | Queue to MTAACP if ANSI 
BDPKT Build an I/O packet 
CKRLK Synchronize and exit 
FCRVB CKNLN Check if file accessed on LUN 
CKRAC Check read access and exit 
FCWVB —s- CKNLN Check if file accessed on LUN 
CKWAC Check write access and exit 
FCCRE CKDMO Check if volume marked for dismount 
CKALN Check if file accessed on LUN 
CKPKT Join common ACP and check mount 
FCDEL CKTRN Check if really truncate 
CKACP Set flag to queue to ACP 
CKMOU Check volume mounted by this user 
BDPKT Build an I/O packet 
CKXIT Exit 
FCPKT CKACP Set flag to queue to ACP 
CKMOU Check volume mounted by this user 
BDPKT Build an I/O packet 
CKXIT Exit 
FCEXT CKPND Increment window pending count for extend 
UNLCK CKNLN Check if file accessed on LUN 
UNLXT Set registers and exit 
FCCON CKDMO Check if volume marked for dismount 
CKALN Check if process already connected on LUN 
CKCON Address check connect buffer 
CKRLK Interlock LUN usage and exit 
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Table 12-2 Polish Routines (Cont) 


Table Routine Function | 

FCDIS CKNLN Check if process connected on LUN 
CKDIS Check buffer and copy parameters 
CKRLK Interlock LUN usage and exit 

FCNCT CKDMO Check if volume marked for dismount 
CKCON Address check buffer 
CKXIT Exit 
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Queuing |/O Requests 


e I/0 request packets are queued by routine $DRORQ in module 
DRSUB 


e Processing in $DRQRQ 
Bit UC.QUE in U.CTL in the UCB is checked 
If set, packet queued to driver 
Contents of KERNEL APR 5 is saved on stack 


If driver loadable, base address of driver loaded into 
KERNEL APR 5 


The driver is called to initiate I/O 
When driver exits 
Control returns to S$SDROQRQ 


Original contents of KERNEL APR 5 are restored 
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ANCILLARY CONTROL PROCESSORS 


Types of ACPs 
e Standard ACPs 
Known to the Executive 
Executive includes special code for support 


Follow rules used by DEC in writing F1lACP and MTAACP 


e User ACPs 
Not known to the Executive 
Known only to the driver which uses their services 


UC.QUE set in U.CTL to prevent ACP function checks 
DRQIO 


Driver does preprocessing and queues requests to ACPs 


No change to the Executive code is necessary 


e Foreign ACPs 
Between standard and user ACPs 
Known to the Executive 
No special services provided to support ACP 


Identified by foreign bit US.FOR in the UCB 
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in 
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CHECK FOR LEGALITY 
CONSTRUCT 1/0 PACKET 
SPECIAL ACP PROCESSING pene 
QUEUE TO ACP IF SPECIFIED 


QUEUE !/O PACKET $DRQRQ 
CALL DRIVER INITIATOR 


DEVICE DRIVER 
CALL $GTPKT 


GET I/O PACKET 
DETERMINE ACP FUNCTION 


$GTPKT 


QUEUE PACKET TO ACP xR 
REQUEST ACP monn 


Figure 12-3 Standard ACP 


342 


I/O PROCESSING 


USER 
TASK 


QIO 


CHECK FOR LEGALITY 


CONSTRUCT I/O PACKET $DRQIO 
COPY I/O PARAMETERS 


JMP 


| CALL DRIVER INITIATOR | $DRQRQ 


JSR 


SPECIAL ACP PROCESSING ER 
QUEUE TO ACP | select acea 


JSR 


QUEUE I/O PACKET TO ACP 
REQUEST ACP $SEXRQP 


Figure 12-4 User ACP 


I/O PROCESSING 


USER 
TASK 


Qio 


CHECK FOR LEGALITY 
CONSTRUCT I/O PACKET 
COPY |/O PARAMETERS ene 
QUEUE TO ACP IF UC.QUE=0 


JMP 


CALL DRIVER INITIATOR $DRQRQ 


JSR 


SPECIAL ACP PROCESSING 
QUEUE I/O PACKET DEVICE DRIVER 
CALL $GTPKT 


JSR 


GET 1/0 PACKET 


DETERMINE ACP FUNCTION | SGTPKT 


JSR 


QUEUE PACKET TO ACP | gexrop 


REQUEST ACP 


Figure 12-5 Foreign ACP 
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The FILES-11 (F11ACP) 


e Implements the FILES-11l structure for disks 
e Provides needed file primitives (open, close, etc.) 
e Converts file primitives to driver primitives 

Open file requires several driver operations: 


Locating the file which may require several reads of 
directory records and headers 


Creating the FCB from the file header 


Creating the window block from the retrieval pointers 


Versions available at SYSGEN 
@ MINIMUM Version 
Not recomended for general use 
Runs in 2K words of memory 
Heavily overlaid 
No internal buffers for storing data 


Mapped and unmapped systems 


e SMALL Version 
Provides limited performance optimization 


Requires 19 to 19@ times more I/O for directory lookups 
and file opens than larger ACPs 


Heavily overlaid 
Runs in 2.5K words of memory 
Mapped and unmapped systems 


Default version for unmapped systems 
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e MIDDLE Version 


Usually provides the best performance without using large 
amount of memory 


Provides buffers for storing directories and the index 
file bitmap 


Runs in 5K words of memory 
Mapped and unmapped systems 


Default version for mapped systems 


e LARGE Version 


Provides the maximum performance for FI11ACP 
Not overlaid 

Runs in 18K words of memory 

Provides larger buffers for storing directories 


Available only on mapped systems 
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DEVICE DRIVER PROCESSING 


INTRODUCTION 


Most. tasks receive raw data from external sources and provide 
results to the user. It is usually necessary to keep large 
amounts of data available to the processor for instant use. To 
provide these services, an I/O system is needed. The basic 
component of this system is the software which handles’ the 
activities of the physical devices. Under RSX-11M, this software 
is called a device driver. 


RSX-11M provides drivers for each supported peripheral 
device. The interface between a driver and the I/O system is 


Simple and standard. The user can write drivers for non-standard 
devices by adhering to the requirements of this interface, 


OBJECTIVES 


1. Diagram the flow of control during device driver processing. 


2. Determine the status of a device by examining its data 
structures. 


3. Diagram the process of performing I/O with a DMA UNIBUS device 
on the PDP-11/44 or 7@. . 


RESOURCES 


1. RSX-11M System Lists and Data Structures 


2. RSX-11M Guide to Writing a Device Driver 
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OVERVIEW 


Methods of Performing I/O 
e Device common 
Partition in I/O Page 
Built and used as any other common area 


Can only perform 'device-poll' device driving 


e Direct access to I/O page 
Privileged task has access to I/O page 


Can only perform 'device-poll' device driving 


e cCINTS Directive 
Task contains essential routines to drive device 
Very little knowledge of system interface required 
Easy to debug 


Interrupt driven 


e Device Driver 
Integral part of the Executive 
Is written to use QIO mechanism 


Usually interrupt driven but can do 'device-poll' 
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Design Philosophy 
e One device driver per device type 


Handles multiple controllers 


e Common I/O processing done in Executive routines 
Queuing of I/O request in module DRQIO 


I/O completion handled by routine SIODON in module IOSUB 


e Keep interrupt lockout to a minimum 
Run at priority 7, no more than 19@ microseconds 


Run at priority of interrupting device, no more than 588 
microseconds 


e Use a FORK process to access the system data base 
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General Fiow 


e User task issues QIO directive 


Executive entered as result of EMT instruction 


e Executive processes QIO 
Checks made on data in DPB 


Mapping adjusted to map to service routine and DPB 


@e Module DRQIO processes QIO 
Checks made on I/O request 


I/O packet created and queued to driver 


e Driver called at initiate I/O entry point 
I/O packet retrieved 
Data in packet processed 
I/O device started 
e Control returns to user task if asynchronous I/0, Executive 
otherwise 


e When interrupt occurs, driver entered at interrupt entry point 
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DRIVER DATA BASE 


e Location 
In module SYSTB for DEC-supplied drivers 
If user-written driver with 


Resident data base, in Executive 
Loadable data base, in DSR 


Device Control Block (DCB) 
@e One per device type 
e Describes static characteristics of device 
e Linked to device list 
Headed by S$DEVHD in Executive module SYSCM 


List linked by D.LNK in DCB 


e Contains 


D.DSP - Address of Driver Dispatch Table 

D.MSK - Function masks for filtering QIO requests 
D.UCB - Link to first UCB 

D.UCBL - Length of UCB for device type 

D.NAM - Generic device name in ASCII 

D.UNIT - Highest and lowest unit number 


Used by QIO processing, not by driver 
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Unit Control Block (UCB) 


One per physical unit 

Contains mostly static data 

Most other data structures can be accessed from UCB 

UCB for unit 8 linked from D.UCB in the DCB for device type 


Other UCBs for device type contiguous with UCB for unit @ 


Contains 
U.DCB - Pointer back to DCB for device type 
U.RED - Pointer to UCB of redirect device 
U.UNIT - Physical unit number 
U.SCB - 


Pointer to SCB of controller for this unit 


Used by both driver and Executive 
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Entry 
U.DCB 
U.SCB 
UL UNIT 


U.RED 


U.STS .. 


U.ST2 


U.CTL 


U.CWl 


U.CW2 
U.CW3 
U.CW4 


U.CLI 


Table 13-1 
Offset Length 
g WORD 
20 WORD 
6 BYTE 
2 WORD 
5 BYTE 
“e BYTE 
4 BYTE 
19 WORD | 
12 WORD 
ia WORD 
16 WORD 
~6 WORD 
-4 WORD 
~2 WORD 
1. 

1. 
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Important Entries in the UCB 


Contents 

Address of DCB for device type 
Address of SCB for unit. 
Physical unit number 

Address of UCB for redirect 


Unit status bits 


More unit status bits 


Unit control flags 
Ist device characteristics word 
2nd device characteristics word 


3rd device characteristics word 


‘ath device characteristics word 
‘Default CLI 


Login UTC 


Owning terminal 


U.CLI and U.LUIC exist only for terminals 
U.LUIC exists if system is multi-user 
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U.STS 
U.ST2 


DV.REC ! DV. CCL 
140100 


Figure 13-1 Unit Control Block for LP: 
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U.DCB 
U.RED 
U.CTL 
U.UNIT 
U.CW1 
U.CW2 
U.CW3 
U.CW4 
U.SCB 
U.ATT 
U.BUF 


U.CNT 


U.ERHL 
U.ERHC 


U.STS 
U.ST2 


DEVICE DRIVER PROCESSING 


Figure 13-2 


Unit Control Block for DK: 
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U.IOC 
U.ERSL 
U.ERSC 
U.OWN 
U.DCB 
U.RED 
U.CTL 
U.UNIT 
U.CW1 
U.CW2 
U.CW3 
U.CW4 
U.SCB 
U.ATT 
U.BUF 


U.CNT 
U.ACP 
U.VCB 


DEVICE DRIVER PROCESSING 


Status Control Block (SCB) 


One SCB per controller 


Line multiplexers (DH-1ll, DJ-1l1l, etc.) have one controller per 


line 


Most information is dynamic 


Linked from U.SCB in the UCB 


One SCB is linked from several UCBs if controller iS common to 
several units 


Contains 
S.LHD 
S.PKT 
S.PRI 
S.CTM 
S.ITM 
S.CSR 


S.FRK 


Device I/O queue listhead 

Address of current I/O packet 
Device priority 

Current time out count 

Initial time out count 

Address of Control Status Register 


The FORK block 


Used by driver and Executive 
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S.ROFF -7 OFFSET TO 1ST REG. -6 S.RCNT 
CONTROLLER I/O O S.LHD 
[CORKS C*d 
24 
28 
UMR NUMBER OF UMR'S ASSIGNED °4 34 M.UMRN 
ASSIGNMENT . 


Figure 13-3 Status Control Block 
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I/O Packet 
e Used to communicate between Executive and device driver 
e Created by Executive in DSR 
e One for each I/O request queued to driver 
e Each SCB has an I/O queue consisting of pending I/O packets 
Linked from listhead S.LHD in the SCB 
Linked in order of decreasing task priority 
Packet is removed from queue when service begins 
e Current I/O packet is linked from S.PKT in the SCB 
e Contains 
I.PRI - Priority of request 
I.EFN - Event flag to use for synchronization 
I.TCB - Address of TCB of requesting task 
I. FCN ~ I/O function code 
I.IOSB - I/O status block sgaveas 
I.AST - Address of AST service routine 
I. PRM - I/O parameter list 
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4 1.78 
10 LUCE 
[MAIN FUNCTION CODE | MODIFIER | 12. LFCN 

16 

20 
22 LAST 
24 L.PRM 

PARAMETERS 26 

1-6 30 

32 

34 

36 

40 


Figure 13-4 I/0 Packet 
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CPU DISK CONTROLLER CONTROLLER 
CONTROLLER DL-11 FOR LP 
RP96 LA36 LP-11 


UCB SCB 
FOR 
DB@: 


DCB UCB SCB 
FOR FOR 
TT: TT¢ 


DCB UCB SCB 
FOR FOR 
LP: LP@: 


Figure 13-5 A Simple Configuration 
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DISK CONTROLLER CONTROLLER 
CPU CONTROLLER DL-11 FOR LP 


SCB 


TT: TT@: 


DCB UCB SCB 
FOR FOR 
LP: LP@: 


Figure 13-6 A Configuration with Multiple Units 
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DISK DISK CONTROLLER CONTROLLER 
CPU CONTROLLER CONTROLLER DL-11 FOR LP 


SCB 


SCB 


DCB UCB 
FOR FOR 
LP: LPS 


Figure 13-7 A Configuration with Multiple Controllers 
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DRIVER STRUCTURE 


Driver Entry Points 


Initiate I/O Entry Point 


Used to initiate an I/O operation 
Called from routine SDRQIO 
Executes at processor priority @ 
Name of entry point: XXINI 


Kill I/O Entry Point 


Cancels in-progress requests for non _ block-addressable 


devices 
Called from routines SDROQIO and SDREIF 
Executes at device priority 


Name of entry point: XXCAN 


Time-out Entry Point 


Used when driver does not interrupt within specified 
interval after a request 


Called from module TDSCH 

Executes at device priority 

Action: Retry I/O operation 

After eight retries, I/O operation is aborted 


Name of entry point: XXTMO 


Powerfail Entry Point 


time 


Called by module INITL and by SAVE to initialize device 


Reinitializes device after powerfail 

Called from routine POWER after power is restored 
Executes at processor priority @ 

Name of entry point: XXPWF 
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Interrupt Entry Point 


Services interrupts from device 
Address stored in interrupt vector 
Entered at processor priority 7 
Entry Point Names Critical 


XXINT - Single interrupt driver 
XXINP - Input, two interrupt drivers 
XXOUT -. Output, two interrupt drivers 


Driver Dispatch Table 


Table containing addresses of service routines for all 


points except the interrupt entry 


Table is in the device driver at location S$XXTBL 


SXXTBL:: 


«WORD XXINI sInitiate I/O 
-WORD XXCAN :Cancel I/0 
-WORD XXTMO ;Device Timeout 
-WORD XXPWF :Powerfail 


Pointed to by D.DSP in the DCB 


Entries are local symbols whose order is critical 
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EMT ORSUB 
TRAP VECTOR 


re) SEMTRP:: 


DEVICE DRIVER 


XXINI 


INITIATE 
70 


DRIVER 


CLOCK INTERRUPT XXCAN: 


VECTOR i 
100 


102 . 
POWERFAIL 
TRAP VECTOR seen ] 
24 i 


i Se ster lina i - el el 


CANCEL 1/0 


TIMEOUT 


POWERFAIL / 
RESTART 


Figure 13-8 Driver Flow 
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*TITLE XxXDRV 


»WORD XXINT 
«WORT XXCAN 
*WORT XXTMO 
»+WORTD XXP WF 


XAINI? CALL €$GTRRT 
BCC ot4 
RETURN 
MOV #1S.SUC&377 eho 
CLR RI 
CALL $ TODOQN 
XXCAWNS 
XXTMOs 


XXPUE S 
XXINTi$ RETURN 
/ENDD | 


Example 13-1 A Skeleton Driver 
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TITLE 

»>MCALL 

NCROF ¢ 

UC RIF 
$XXDATS ¢ 
AXDCR? «WORD 
»WORT 
+ASCITI 
+BYTE 
«WORT 
»>WORT 
+WORT 
+» WORT 
«WORT 
«WORD 
»WORT 
«WORT 
«WORD 
»*WORD 
-WORD 


XXST=. 
eXXGT? »+WORD 
«WORT 
»~BYTE 
«WORT 
«WORD 
«WORD 
«WORT 
«WORT 
» WORT 
»WORT 
XXNIt=, 
$XXO72 WORT 
+WORD 
eWORT 


$XXENDS 3 
»END 


Example 13-2 


XXTAB 
UCKIFS »UCRDFS 


0 

+XXO 
AXX/ 
QvQ 
XXNII-XXST 
0 
L?7?7777 
30 

Q 
177740 
377 

0 

0 

377 

0 


XXIICE 

en 

OvsUS.MNT O20 
DV.MNTIOV.F Ad 
070 

SO. 

$xxo 

0907090 

9) 

Q 


0 


ies 2) 
* ae 


eU. ACF 
yU.VCE 


O9OrOeOvrOvxOxQsO9090 


A Skeleton Driver Data 
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Base 
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DRIVER PROCESSING 


Initiate |1/O 
e Call SGTPKT to get an I/O packet 
Carry set on return from SGTPKT 
No packet 
ACP function 


Controller busy 


-@ Registers on return from $GTPKT 
Rl - Address of I/O packet 
R2 - Physical unit number 
R3 - Controller index (into CNTBL) 
R4 - Address of SCB 


R5 - Address of UCB 


e UCB address saved in CNTBL 
e Perform initiation of I/O including 
Allocating UMRs if a DMA device on 11/44 or 11/79 
Setting up device timeout 
If error logging, call $BMSET 
Checking function code 
Performing operations on CSR(s) 
Mapping UMR(s) if required 


Enabling interrupts 
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Kill 1/O 
e Registers when entry point called 


R5 - Address of UCB 


R4 Address of SCB 


R3 


Controller index 
Rl - TCB of current task 


R@ 


Active I/O packet 


e Processor is at device priority when called 
e Cancel current I/O operation by 
zeroing byte-count or flagging abort 


Canceling timeout by zeroing S.CTM in the SCB 


e For DMA devices, current operation may not be canceled 
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Device Timeout 


e Registers when entry point called 


R5 - Address of UCB 
R4 -— Address of SCB 
R3 - Controller index 


R2 -—- Address of CSR 


R@ - I/O status code (IE.DNR) 


e Processor at device priority when called 

e Generate error message by calling SDVMSG with T.NDNR in R@ 
e If error logging, call SDTOER | 

e Reset timeout count if required 


@e Retry I/0 operation required number of times 
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Powerfail 

e Registers when entry point is called 
R5 - Address of UCB 
R4 - Address of SCB 


R3 - Controller index 


@e Processor at processor priority @ when called 

e Uses timeout mechanism for device recovery 
Special timeout count is used for many devices 
Performs other initialization tasks (e.g., the KMC-11 for 
the lineprinter) 

Interrupt Processing 


e Registers R4 and R5 saved on entry, others cannot be used 
except in FORK process code 


e Processor priority 


At call: 7 


After return from SINTSV: Device priority 


During FORK processing: @ 
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DEVICE DRIVER 
ENABLE INTERRUPT CONTROLLER 


DATA BUFFER REG. 


INTERRUPT ENTRY 
GET CHARACTER 
PUT INTO USER BUFFER 
END OF LINE? 
IF NOT REPEAT 
IF YES 


COMPLETE 1/0 


USER DATA 
BUFFER 


Figure 13-9 Interrupt Processing - Non DMA Device 
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DEVICE DRIVER CONTROLLER 


LOAD BUS ADDRESS 


UNIBUS ADDRESS REG. 
WORD COUNT REG. 
e 


LOAD WORD COUNT 


LOAD SECTOR. TRACK. ETC. 


ENABLE INTERRUPT 


@ 
CONTROL STATUS REG. 


START TRANSFER 


INTERRUPT ENTRY ISSUE INTERRUPT 


USER DATA 
BUFFER 


Figure 13-18 Interrupt Processing - DMA Device 
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ADVANCED DRIVER FEATURES 


Loadable Drivers 


Not physically within the Executive, but in a user partition 
Frees part of KERNEL address space to be used to map added DSR 
LOAD command brings into memory 
UNLOAD command removes from memory 
Consists of three parts 

Interrupt Control Block in DSR 

Driver code loaded into driver partition 


Driver Data Base loaded in DSR 


The Interrupt Control Block 


Created by LOAD command in DSR 

Contains 
Location to which control is transfered by interrupt 
Call to interrupt save routine, to save registers 


Code to map driver code using KERNEL APR 5 
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TXORV 


SXXINT:: 


RESUME USER 
TASK 


Figure 13-11 A Loadable Driver 
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113767 
177776 MFPS TEMP 


004537 
JSR RS, @#$INTSV 


ADDR OF $INTSV 
177753(TYPICAL) .WORD ¢ C <PR1> 
016704 
000036 
043704 
177760 


006304 ASL R41 | 


MOV TEMP.R4! 


BICtC<17>,R4! 


013746 

172352 

012737 

DRIVER RELOCATION BIAS MOV # RELBAS,@#KISAR5 

172352 

004737 JSR PC,e#INTSRV 

ADDRESS OF INTERRUPT SERVICE ROUTINE 

012637 

172352 

000000 TEMP:.BLKW 1! 
1, MULTI-CONTROLLER DRIVERS 


MOV @#KISARS, -(SP) 


MOV (SP)+,e#KISAR5 


Figure 13-12 The Interrupt Control Block 
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Resident and Loadable Data Base 


Data base for loadable driver can be loadable or resident 


Resident data base created when system is built and _ included 
in the Executive 


Loadable data base can be created at any time 


Loaded in DSR by LOAD command if not already in memory 


Not unloaded by UNLOAD command 


UNIBUS Mapping Registers 


Problem: 


Direct Memory Access (DMA) devices 


Transfer data directly between the device and physical 
memory 


Require physical address to be passed to UNIBUS 


In some PDP-lls, physical addresses require 22 bits 


UNIBUS accepts only 18-bit addresses 


Solution: 


31 UNIBUS Mapping Registers (UMRS) are provided 
Each UMR maps 4K words of physical memory 


124K words of address space just below the I/O page are 
relocated using UMRs 
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UNIBUS MAPPING REGISTERS PHYSICAL 


007444 


740000 


563200 
543200 


120000 


100000 


004070 


003670 
003470 


060000 
040000 
20000 


000000 


Figure 13-13 UNIBUS Mapping Registers 
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TRANSFER A BLOCK OF 8K WORDS 

USER BUFFER ANURESS = 1344200 
UMR’S 3 AND 4 ARE TO BE USED 

UMR STRUCTURE 3 


BITS 213-17 


NUMBER OF UMR 
BITS O -12 = OFFSET TO BASE ADDRESS IN UMR 
THEREFORE ¢ 


UMR 3 


13442 
UMR 4 = 13642 


THE ADDRESS SUPPLIED TO THE UNIBUS IS 060000 


Example 13-3  UMR Address Relocation 
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DEVICE DRIVER PROCESSING 


SCB SCB SCB 


$UMRHD 


MAPPING 
ASSIGNMENT 
BLOCK 


MAPPING 
ASSIGNMENT 
BLOCK 


MAPPING 
ASSIGNMENT 
BLOCK 


IN ORDER OF UMR NUMBER 


Figure 13-14 Mapping Assignment Block List 


SCB SCB SCB 


MAPPING 
ASSIGNMENT 
BLOCK 


MAPPING 
ASSIGNMENT 
BLOCK 


MAPPING 
ASSIGNMENT 
BLOCK 


FIFO QUEUE 


Figure 13-15 UMR Wait Queue 
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DEVICE DRIVER PROCESSING 


CONNECT-TO-INTERRUPT 


Privileged task which contains interrupt service routine, ISR 
Task may or may not be mapped to Executive 
Connect-to-interrupt directive (CINT$) used to set up 
interrupt service 
Interrupt Transfer Block (ITB) created in pool 


Address X.JSR in ITB loaded into PC of specified 
vector 


Vector must be greater than 6@ and unused 
ITB contains code to map the ISR through KERNEL APR 5 and 
transfer control to it 
ITB also contains FORK block for ISR 


ITB linked to the ITB list of the task using T.CPCB in the 
TCB 


Task is made noncheckpointable and nonshufflable 
Connect-to-interrupt directive performs disconnect if issued 
with address of ISR equal to 9 

Task is made checkpointable and shufflable regardless of 


original status 


Interrupt service routine is limited to 4K words 
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DEVICE DRIVER PROCESSING 


ITB $INTSC 


CALL $INTSC MAP KAPRS 
OVER ISR 


INTERRUPT 


CALL ISR 
SAVE R9-R3 


DEVICE 
CONTROLLER 


$DIRXT 


Figure 13-16 Connect-to-Interrupt Processing 


383 


DEVICE DRIVER PROCESSING 


iad JSR RS, #$INTSC nee 
ADDRESS OF $INTSC 4 
LINK TO NEXT FORK BLOCK 12 X.FORK 

FORKBLOCK paket 

SAVED R5 

SAVED R4 
ADDRESS OF DISABLE INTERRUPT ROUTINE X.DSI 
X.AST 

AST BLOCK 


1. IF AST SUPPORT THIS IS FIRST AND ONLY AST PARAMETER 


Figure 13-17 The Interrupt Transfer Block 
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DEVICE DRIVER PROCESSING 


sTITLe OFt 
+IUENT /4.0/ 


eT THIS TASK ILLUSTRATES THE CONNECT TO INTERRUPT VECTOR DIRECTIVE 
: THIS FRIVILEGED TASK CONNECTS TO A DR-1iK. THERE IS A 
i LOCAL OPERATOR CONSOLE (LOC BOX) ATTACHED TO THE DR-11K 
: WHICH HAS 3 FUSH BUTTONS. THESE 3 SWITCHES WILL CAUSE 
: THE UR-11 TQ INTERRUPT AND TO PERFORM THE FOLLOWING 
; OPERATIONS ? 
} SWITCH 1 ~ THE INTERRUPT SERVICE ROUTINE 
WILL SAMPLE THE TIME» AND STORE 
3 THE NUMBER OF TICKS TO THE NEXT 
i SECOND IN A BUFFER. 
3 SWITCH 2 ~ THE ISR QUEUES AN AST TO THIS TASK 
3 WHICH WILL AVERAGE THE VALUES COLLECTED 
i IN THE ISR AND PRINT IT ON ‘TI’, 
, SWITCH 3 - THE ISR SETS A LOCAL EVENT FLAG WHICH 
3 CAUSES THIS TASK TO DISCONNECT FROM 
? THE VECTOR ANI EXIT. 
*MCALL CINTS&eEXITES es QTOWS sASTXES eWTSES se DIRS 
+NLIST BEX 
i NEF INITIONS FOR THE DR-11K 
ORVEC = 230 » VECTOR 
NRCSR = 167770 sCONTROL ANT STATUS REGISTER 
NRBUF Es 167772 sINFUT BUFFER REGISTER 
SWTCHL = 1 PSWITCH 1 
SWICHS = 2 ISWITCH 2 
SWTCHS = 4 sSWITCH 3 
EF = 2 sEVYVENT FLAG FOR TASK 
RUFSIZ = 30. yNUMBER OF SAMPLES TO STORE 
PINTS CINTS DIRVECs ISRBAS» URINT sOREDIR ys PRS» GRAST ¥ CONNECT 
MCINT: CINT¢ QRVEC #0 TSCONNECT 
WAIT: WYSE $ Er yWAITT FOR EF 
FRINT? OQITOW¢ TO.WVBe Selby sss MESe Or 40> eFRINT AVERAGE 


FORMAT? .ASCIZ /NUMBER 


ERR $ 


MES: 


|r 6h 


“So "Se SE 


LOSS 


OF SAMPLES TAKEN “Dl. AVERAGE OF THE SAMPLES 40/ 
TQ CONNECT TO VECTOR. DIRECTIVE STATUS = “£D./ 


*FORMATTEM MESSAGE 


CONNECT TO ODR-11iK INTERRUPT VECTOR AN FUT TASK TO SLEEF BY 


EVENT FLAG 2 


SINITIALIZE NUMBER OF SAMPLES 
YINITIALIZE SUM 

sCONNECT TO INTERRUPT 

*FAILEG TQ CONNECT 

sFPUT TASK TO SLEEF 

> DISCONNECT 


COMNECT FAILED - FRINT ERROR MESSAGE 


*eASCIZ /FATLED 
sEVEN 
+ BLAKE 100. 
*ENABL LSE 
MAIN LINE CODE 
WATTING ON LOCAL 
re 
CLR COUNT 
CLA BUFFER 
NIRS ¥CINT 
BCS 10% 
NIRS #WAIT 
DIRS F0C INT 
EXIT#S 
MOV ¥MESeRO 
MOV ¥ERR»R1 


sOUTFUT BUFFER 
sFORMAT SFECIFICATION 


Example 13-4 Sample Connect-to-Interrupt Routine 
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“er “> 


So 


DRAST3 


“A> ‘Ob 


> GP SSR ER Ee 


ISRBAS? 
? 
COUNT: 
BUFFER? 


“E> GS “Sh MES Sd ER 


“=> “E> 


“a> 


OREDIR: 


— 


208s 


S2h “Sr SEP “se SD 


“S> “> 


DRINT $ 


DEVICE DRIVER PROCESSING 


MOV #$TISWe RQ VALUE TO BE CONVERTED 

CALL. $E0IMSG yFORMAT MESSAGE 

MOV + RivsFRINT+Q.IOPL+2 ¢NUMBER OF BYTES IN MESSAGE 
DIRS #P RINT sPRINT ERROR MESSAGE 

EXIT&S 


AST WILL AVERAGE THE TIME SAMFLES ANI PRINT ON TI 


MOV COUNT » RO sNUMBER OF SAMPLES 
BEQ 3S¢ ySKIF AVERAGING 

CLR Ri FACCUMULATE SUM IN Ri 
MOV #RUFFER ys R2 ¥SAMPLES TO SUM 

MOVE CRS.+9 RS §GET SAMPLE 

BIC #1774002R3 sON’T SIGN EXTEND 
Aun R3:R1 yALL! INTO TOTAL. 

£06 ROv1S$ *GET NEXT VALUE 

NIV COUNT » RO *GET AVERAGE 

MOV Ri» BUFFER *STORE QUOTIENT 

MOV ¥MES¥ RO sOUTFUT STRING 

MOV #FORMAT sFORMAT SPECIFICATION 
MOV #COUNT se R2 sNUMBERS TO CONVERT 
CALL $E0MSG #CONVERT MESSAGE 

MOV RivFRINT+Q,IOPL+2 sNUMBER OF BYTES TO FRINT 
Qiks FFP RINT sWRITE SAMPLE AVERAGE 
TST (SF) + eFOF VECTOR ADGRESS 
CLA BUFFER sRE-INITIALIZE SUM 
CLE COUNT 7ANT COUNT OF SAMPLES 
ASTX$S yEXIT AST 


ISRBAS DEFINES THE BASE ADDRESS OF A 4K-WORD AREA THE 
EXECUTIVE WILL MAF WITH KERNEL APRS. THIS AREA MUST 
CONTAIN THE INTERRUPT SERVICE ROUTINE? THE ENABLE/TDISABLE 
INTERRUPT ROUTINE» ANT ANY TATA AREAS THAT THESE ROUTINES 
WILL REFERENCE. 


UATA BUFFERS NEEDED BY ISR 


«WORD Q yNUMBER OF SAMPLES 
«BLAKE BUF SIZ YBUFFER FOR INFUTS 
+EVEN 


ENABLE/UISABLE INTERRUPTS ROUTINE 
AUTOMATICALLY CALLEQ UNDER 3 CONDITIONS 
1. WHEN THE TASK CONNECTS TO AN INTERRUFT VECTOR 
TO ENABLE INTERRUPTS, 
2. WHEN THE TASK [DISCONNECTS FROM THE INTERRUPT 
VECTOR TO DISABLE INTERRUFTS. 
3. WHEN THE TASK IS ARORTED TO DISABLE INTERRUFTS. 


RCS 208 yIF CS DOITSABLE INTERRUPTS 
BIS #100/@#DIRCSR yENABLE INTERRUPTS 

RETURN SAND OUT 

LIC #100, @#LIRCSR sNISABLE INTERRUPTS 
RETURN yANT OUT 


INTERRUFT SERVICE ROUTINE 

THE TSR IS ENTERED AT FRIORITY 3S (SPECIFIED ON CINT#) WITH 
R4 = SAVET AND FREE TO BE USED 
RS = ADDRESS OF FORK BLOCK IN THE ITER 


RIT #SWTCHIy@#O0RBUF 3s INPUT BUFFER REQUEST? 


Example 13-4 Sample Connect-to-Interrupt Routine 
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DEVICE DRIVER PROCESSING 


REQ 30% ¥33IF EQs NO 
CMF #BUFSIZ*sCOUNT *s9YES» BUFFER FULL? 
REQ IOS s33IF EQs YES 
MOV COUNT sR4 s°31F NEv NO 
Alt FC sR4 #33CALCULATE BUFFER 
An #BUFFER—. »R4 995PIC ADIRESS TO STORE SAMPLE 
MOVE GHEETTNS» (R4) *ysLOW BYTE OF TICKS TILL NEXT SECOND 
INC COUNT se 3 INCREMENT NUMBER OF SAMPLES 
BR 30% $3 9EXIT FROM INTERRUPT 
; INTERRUFT WAS FROM SWITCH 2 OF 3 
3 
3OE3 CALL G#$FORK2 es SCREATE A SYSTEM FROCESS 
CLR (RS) SNECLARE THE FORK BLOUR FREE 
RIT #SWTCHS*s@#DRBUF s DISCONNECT FROM INTERRUDT? 
BNE 40% gIF NEs YES 
; SWETCH 2 => QUEUE AN AST TO THE TASK 
3 
CALL. S#EQASTC sQUEUE AN AST 
ER 5O€ yEXIT FROM INTERRUPT 
; SWITCH 3 =» DISCONNECT FROM INTERRUPTS. 
ry SET LOCAL EVENT FLAG 2 TO WAKE UF TASK LEVEL CODE TO 
# ISSUE THE DISCONNECT 
3 
493 MOV #EF FO sEVENT FLAG 2 TQ EE SET 
MOV X.TCBR-X.FORK (RS) sRS eRS FOINTS TQ THE TCR OF TASK 
CALL C#ESETF t#EXEC SUBROUTINE SETF 
RETURN sEXIT INTERRUPT 
EXIT FROM INTERRUPT. TURN INTERRUPT BACK ON. 
i 
SOS BIS #100°040RCSR *TURN ON INTERRUPTS 
RETURN sEXIT FROM INTERRUPT 
¥ 
3 ENSURE ISk + DATA + ENABLE/DTSABLE SURBOUTINES FIT IN 4K 
: 
+ TIF LTesi20000 - <. - ISRBAS?> ERROR 
»END START 


Example 13-4 Sample Connect—to-Interrupt Routine 
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